diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 2001-03-11 05:02:31 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 2001-03-11 05:02:31 +0000 |
commit | fe835c13d60b858dba6378a981af7e67eebe031e (patch) | |
tree | 8750e2ab2a15879c176324604e8a70f60dbca837 /lib/libc/sys | |
parent | 2b7e8786fb3995460df7de9ab0f010996e81bb22 (diff) |
mdoc police.
Diffstat (limited to 'lib/libc/sys')
-rw-r--r-- | lib/libc/sys/accept.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/intro.2 | 133 | ||||
-rw-r--r-- | lib/libc/sys/kqueue.2 | 184 | ||||
-rw-r--r-- | lib/libc/sys/sigaction.2 | 12 |
4 files changed, 175 insertions, 158 deletions
diff --git a/lib/libc/sys/accept.2 b/lib/libc/sys/accept.2 index 1e898fa809f..62240239824 100644 --- a/lib/libc/sys/accept.2 +++ b/lib/libc/sys/accept.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: accept.2,v 1.11 2001/02/07 12:48:37 itojun Exp $ +.\" $OpenBSD: accept.2,v 1.12 2001/03/11 05:02:29 aaron Exp $ .\" $NetBSD: accept.2,v 1.7 1996/01/31 20:14:42 mycroft Exp $ .\" .\" Copyright (c) 1983, 1990, 1991, 1993 @@ -156,7 +156,7 @@ The per-process descriptor table is full. .It Bq Er ENFILE The system file table is full. .It Bq Er ECONNABORTED -A connection has been aborted. +A connection has been aborted. .El .Sh SEE ALSO .Xr bind 2 , diff --git a/lib/libc/sys/intro.2 b/lib/libc/sys/intro.2 index b1271fa1e2a..5e44baa81af 100644 --- a/lib/libc/sys/intro.2 +++ b/lib/libc/sys/intro.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: intro.2,v 1.17 2000/10/18 05:12:10 aaron Exp $ +.\" $OpenBSD: intro.2,v 1.18 2001/03/11 05:02:29 aaron Exp $ .\" $NetBSD: intro.2,v 1.6 1995/02/27 12:33:41 cgd Exp $ .\" .\" Copyright (c) 1980, 1983, 1986, 1991, 1993 @@ -55,16 +55,14 @@ variable .Va errno , which is defined as: .Pp -.Dl extern int errno +.Dl extern int errno; .Pp -When a system call detects an error, -it returns an integer value -indicating failure (usually \-1) -and sets the variable +When a system call detects an error, it returns an integer value +indicating failure (usually \-1) and sets the variable .Va errno accordingly. -<This allows interpretation of the failure on receiving -a \-1 and to take action accordingly.> +(This allows interpretation of the failure on receiving +a \-1 and to take action accordingly.) Successful calls never set .Va errno ; once set, it remains until another error occurs. @@ -104,11 +102,9 @@ This error will not be reported until a subsequent operation on the same file descriptor and may be lost (over written) by any subsequent errors. .It Er 6 ENXIO Em "\&No such device or address" . Input or output on a special file referred to a device that did not -exist, or -made a request beyond the limits of the device. -This error may also occur when, for example, -a tape drive is not online or no disk pack is -loaded on a drive. +exist, or made a request beyond the limits of the device. +This error may also occur when, for example, a tape drive is not online or +no disk pack is loaded on a drive. .It Er 7 E2BIG Em "Arg list too long" . The number of bytes used for the argument and environment list of the new process exceeded the limit @@ -116,10 +112,8 @@ list of the new process exceeded the limit (specified in .Aq Pa sys/param.h ) . .It Er 8 ENOEXEC Em "Exec format error" . -A request was made to execute a file -that, although it has the appropriate permissions, -was not in the format required for an -executable file. +A request was made to execute a file that, although it has the appropriate +permissions, was not in the format required for an executable file. .It Er 9 EBADF Em "Bad file descriptor" . A file descriptor argument was out of range, referred to no open file, or a read (write) request was made to a file that was only open for @@ -137,8 +131,7 @@ would have resulted in a deadlock situation. .It Er 12 ENOMEM Em "Cannot allocate memory" . The new process image required more memory than was allowed by the hardware or by system-imposed memory management constraints. -A lack of swap space is normally temporary; however, -a lack of core is not. +A lack of swap space is normally temporary; however, a lack of core is not. Soft limits may be increased to their corresponding hard limits. .It Er 13 EACCES Em "Permission denied" . An attempt was made to access a file in a way forbidden @@ -157,13 +150,10 @@ for instance, as the new link name in a .Xr link 2 function. .It Er 18 EXDEV Em "Improper link" . -A hard link to a file on another file system -was attempted. +A hard link to a file on another file system was attempted. .It Er 19 ENODEV Em "Operation not supported by device" . -An attempt was made to apply an inappropriate -function to a device, -for example, -trying to read a write-only device such as a printer. +An attempt was made to apply an inappropriate function to a device, +for example, trying to read a write-only device such as a printer. .It Er 20 ENOTDIR Em "Not a directory" . A component of the specified pathname existed, but it was not a directory, when a directory was expected. @@ -181,8 +171,8 @@ Maximum number of file descriptors allowable on the system has been reached and a requests for an open cannot be satisfied until at least one has been closed. .It Er 24 EMFILE Em "Too many open files" . -<As released, the limit on the number of -open files per process is 64.> +(As released, the limit on the number of +open files per process is 64.) .Xr getdtablesize 3 will obtain the current limit. .It Er 25 ENOTTY Em "Inappropriate ioctl for device" . @@ -201,12 +191,11 @@ The size of a file exceeded the maximum (about 2.1E9 bytes). .It Er 28 ENOSPC Em "Device out of space" . A .Xr write 2 -to an ordinary file, the creation of a -directory or symbolic link, or the creation of a directory -entry failed because no more disk blocks were available -on the file system, or the allocation of an inode for a newly -created file failed because no more inodes were available -on the file system. +to an ordinary file, the creation of a directory or symbolic link, +or the creation of a directory entry failed because no more disk +blocks were available on the file system, or the allocation of an +inode for a newly created file failed because no more inodes were +available on the file system. .It Er 29 ESPIPE Em "Illegal seek" . An .Xr lseek 2 @@ -221,11 +210,10 @@ of 32767 hard links per file). .It Er 32 EPIPE Em "Broken pipe" . A write on a pipe, socket or .Tn FIFO -for which there is no process -to read the data. +for which there is no process to read the data. .It Er 33 EDOM Em "Numerical argument out of domain" . -A numerical input argument was outside the defined domain of the mathematical -function. +A numerical input argument was outside the defined domain of +the mathematical function. .It Er 34 ERANGE Em "Numerical result out of range" . A numerical result of the function was too large to fit in the available space (perhaps exceeded precision). @@ -271,8 +259,7 @@ system or no implementation for it exists. .It Er 45 EOPNOTSUPP Em "Operation not supported" . The attempted operation is not supported for the type of object referenced. Usually this occurs when a file descriptor refers to a file or socket -that cannot support this operation, -for example, trying to +that cannot support this operation, for example, trying to .Em accept a connection on a datagram socket. .It Er 46 EPFNOSUPPORT Em "Protocol family not supported" . @@ -344,8 +331,7 @@ A path name lookup involved more than 8 symbolic links. .It Er 63 ENAMETOOLONG Em "File name too long" . A component of a path name exceeded 255 .Pq Dv MAXNAMELEN -characters, or an entire -path name exceeded 1023 +characters, or an entire path name exceeded 1023 .Pq Dv MAXPATHLEN Ns -1 characters. .It Er 64 EHOSTDOWN Em "Host is down" . @@ -364,17 +350,14 @@ The quota system ran out of table entries. .It Er 69 EDQUOT Em "Disc quota exceeded" . A .Xr write 2 -to an ordinary file, the creation of a -directory or symbolic link, or the creation of a directory -entry failed because the user's quota of disk blocks was -exhausted, or the allocation of an inode for a newly -created file failed because the user's quota of inodes -was exhausted. +to an ordinary file, the creation of a directory or symbolic link, +or the creation of a directory entry failed because the user's quota +of disk blocks was exhausted, or the allocation of an inode for a newly +created file failed because the user's quota of inodes was exhausted. .It Er 70 ESTALE Em "Stale NFS file handle" . An attempt was made to access an open file (on an .Tn NFS -filesystem) -which is now unavailable as referenced by the file descriptor. +filesystem) which is now unavailable as referenced by the file descriptor. This may indicate the file was deleted on the .Tn NFS server or some @@ -386,13 +369,11 @@ information was unsuccessful. .It Er 73 ERPCMISMATCH Em "RPC version wrong" . The version of .Tn RPC -on the remote peer is not compatible with -the local version. +on the remote peer is not compatible with the local version. .It Er 74 EPROGUNAVAIL Em "RPC prog. not avail" . The requested program is not registered on the remote host. .It Er 75 EPROGMISMATCH Em "Program version wrong" . -The requested version of the program is not available -on the remote host +The requested version of the program is not available on the remote host .Pq Tn RPC . .It Er 76 EPROCUNAVAIL Em "Bad procedure for program" . An @@ -533,7 +514,8 @@ A process is recognized as a process and is granted special privileges if its effective user ID is 0. .It Special Processes The processes with process IDs of 0, 1, and 2 are special. -Process 0 is the scheduler. Process 1 is the initialization process +Process 0 is the scheduler. +Process 1 is the initialization process .Xr init 8 , and is the ancestor of every other process in the system. It is used to control the process structure. @@ -579,8 +561,8 @@ by the shell. Note also that .Pq Dv MAXNAMELEN is an upper limit fixed by the kernel, meant to be used for sizing buffers. -Some filesystems may have additional restrictions. These can be queried -using +Some filesystems may have additional restrictions. +These can be queried using .Xr pathconf 2 and .Xr fpathconf 2 . @@ -606,13 +588,13 @@ If a path name begins with a slash, the path search begins at the .Em root directory. Otherwise, the search begins from the current working directory. -A slash by itself names the root directory. An empty -pathname refers to the current directory. +A slash by itself names the root directory. +An empty pathname refers to the current directory. .It Directory A directory is a special type of file that contains entries that are references to other files. -Directory entries are called links. By convention, a directory -contains at least two links, +Directory entries are called links. +By convention, a directory contains at least two links, .Ql \&. and .Ql \&.. , @@ -620,40 +602,43 @@ referred to as .Em dot and .Em dot-dot -respectively. Dot refers to the directory itself and -dot-dot refers to its parent directory. +respectively. +Dot refers to the directory itself and dot-dot refers to its +parent directory. .It "Root Directory and Current Working Directory" Each process has associated with it a concept of a root directory and a current working directory for the purpose of resolving path -name searches. A process's root directory need not be the root -directory of the root file system. +name searches. +A process's root directory need not be the root directory of +the root file system. .It File Access Permissions Every file in the file system has a set of access permissions. These permissions are used in determining whether a process may perform a requested operation on the file (such as opening -a file for writing). Access permissions are established at the -time a file is created. They may be changed at some later time -through the +a file for writing). +Access permissions are established at the time a file is created. +They may be changed at some later time through the .Xr chmod 2 call. .Pp File access is broken down according to whether a file may be: read, -written, or executed. Directory files use the execute -permission to control if the directory may be searched. +written, or executed. +Directory files use the execute permission to control if the directory +may be searched. .Pp File access permissions are interpreted by the system as they apply to three different classes of users: the owner of the file, those users in the file's group, anyone else. Every file has an independent set of access permissions for -each of these classes. When an access check is made, the system -decides if permission should be granted by checking the access -information applicable to the caller. +each of these classes. +When an access check is made, the system decides if permission should be +granted by checking the access information applicable to the caller. .Pp Read, write, and execute/search permissions on a file are granted to a process if: .Pp -The process's effective user ID is that of the superuser. (Note: -even the superuser cannot execute a non-executable file.) +The process's effective user ID is that of the superuser. +(Note: even the superuser cannot execute a non-executable file.) .Pp The process's effective user ID matches the user ID of the owner of the file and the owner permissions allow the access. diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2 index 9483170b46a..94c6e4db0ae 100644 --- a/lib/libc/sys/kqueue.2 +++ b/lib/libc/sys/kqueue.2 @@ -1,4 +1,5 @@ -.\" $OpenBSD: kqueue.2,v 1.5 2001/03/01 20:56:37 provos Exp $ +.\" $OpenBSD: kqueue.2,v 1.6 2001/03/11 05:02:29 aaron Exp $ +.\" .\" Copyright (c) 2000 Jonathan Lemon .\" All rights reserved. .\" @@ -45,7 +46,8 @@ .Fn kqueue provides a generic method of notifying the user when an event happens or a condition holds, based on the results of small -pieces of kernel code termed filters. +pieces of kernel code termed +.Dq filters . A kevent is identified by the (ident, filter) pair; there may only be one unique kevent per kqueue. .Pp @@ -59,11 +61,12 @@ The filter is also run when the user attempts to retrieve the kevent from the kqueue. If the filter indicates that the condition that triggered the event no longer holds, the kevent is removed from the kqueue and -is not returned. +is not returned. .Pp Multiple events which trigger the filter do not result in multiple kevents being placed on the kqueue; instead, the filter will aggregate -the events into a single struct kevent. +the events into a single +.Li struct kevent . Calling .Fn close on a file descriptor will remove any kevents that reference the descriptor. @@ -94,22 +97,26 @@ are applied before any pending events are read from the queue. gives the size of .Fa changelist . .Fa eventlist -is a pointer to an array of kevent structures. +is a pointer to an array of kevent structures. .Fa nevents determines the size of .Fa eventlist . If .Fa timeout -is a non-NULL pointer, it specifies a maximum interval to wait -for an event, which will be interpreted as a struct timespec. If +is a non-null pointer, it specifies a maximum interval to wait +for an event, which will be interpreted as a +.Li struct timespec . +If .Fa timeout -is a NULL pointer, +is a null pointer, .Fn kevent -waits indefinitely. To effect a poll, the +waits indefinitely. +To effect a poll, the .Fa timeout -argument should be non-NULL, pointing to a zero-valued +argument should be non-null, pointing to a zero-valued .Va timespec -structure. The same array may be used for the +structure. +The same array may be used for the .Fa changelist and .Fa eventlist . @@ -133,7 +140,7 @@ struct kevent { .Ed .Pp The fields of -.Fa struct kevent +.Li struct kevent are: .Bl -tag -width XXXfilter .It ident @@ -141,14 +148,14 @@ Value used to identify this event. The exact interpretation is determined by the attached filter, but often is a file descriptor. .It filter -Identifies the kernel filter used to process this event. The pre-defined -system filters are described below. +Identifies the kernel filter used to process this event. +The pre-defined system filters are described below. .It flags Actions to perform on the event. .It fflags Filter-specific flags. .It data -Filter-specific data value. +Filter-specific data value. .It udata Opaque user-defined value passed through the kernel unchanged. .El @@ -157,35 +164,38 @@ The .Va flags field can contain the following values: .Bl -tag -width XXXEV_ONESHOT -.It EV_ADD -Adds the event to the kqueue. Re-adding an existing event -will modify the parameters of the original event, and not result -in a duplicate entry. Adding an event automatically enables it, -unless overridden by the EV_DISABLE flag. -.It EV_ENABLE +.It Dv EV_ADD +Adds the event to the kqueue. +Re-adding an existing event will modify the parameters of the original event, +and not result in a duplicate entry. +Adding an event automatically enables it, unless overridden by the +.Dv EV_DISABLE +flag. +.It Dv EV_ENABLE Permit .Fn kevent to return the event if it is triggered. -.It EV_DISABLE +.It Dv EV_DISABLE Disable the event so .Fn kevent -will not return it. The filter itself is not disabled. -.It EV_DELETE -Removes the event from the kqueue. Events which are attached to -file descriptors are automatically deleted on the last close of -the descriptor. -.It EV_ONESHOT +will not return it. +The filter itself is not disabled. +.It Dv EV_DELETE +Removes the event from the kqueue. +Events which are attached to file descriptors are automatically deleted +on the last close of the descriptor. +.It Dv EV_ONESHOT Causes the event to return only the first occurrence of the filter -being triggered. After the user retrieves the event from the kqueue, -it is deleted. -.It EV_CLEAR +being triggered. +After the user retrieves the event from the kqueue, it is deleted. +.It Dv EV_CLEAR After the event is retrieved by the user, its state is reset. This is useful for filters which report state transitions -instead of the current state. Note that some filters may automatically -set this flag internally. -.It EV_EOF +instead of the current state. +Note that some filters may automatically set this flag internally. +.It Dv EV_EOF Filters may set this flag to indicate filter-specific EOF condition. -.It EV_ERROR +.It Dv EV_ERROR See .Sx RETURN VALUES below. @@ -198,7 +208,7 @@ and .Va data fields in the kevent structure. .Bl -tag -width EVFILT_SIGNAL -.It EVFILT_READ +.It Dv EVFILT_READ Takes a descriptor as the identifier, and returns whenever there is data available to read. The behavior of the filter is slightly different depending @@ -218,7 +228,7 @@ subject to the value of the socket buffer. This may be overridden with a per-filter low water mark at the time the filter is added by setting the -NOTE_LOWAT +.Dv NOTE_LOWAT flag in .Va fflags , and specifying the new low water mark in @@ -228,7 +238,9 @@ On return, contains the number of bytes in the socket buffer. .Pp If the read direction of the socket has shutdown, then the filter -also sets EV_EOF in +also sets +.Dv EV_EOF +in .Va flags , and returns the socket error (if any) in .Va fflags . @@ -244,25 +256,33 @@ Returns when the there is data to read; .Va data contains the number of bytes available. .Pp -When the last writer disconnects, the filter will set EV_EOF in +When the last writer disconnects, the filter will set +.Dv EV_EOF +in .Va flags . -This may be cleared by passing in EV_CLEAR, at which point the -filter will resume waiting for data to become available before -returning. +This may be cleared by passing in +.Dv EV_CLEAR , +at which point the filter will resume waiting for data to become +available before returning. .El -.It EVFILT_WRITE +.It Dv EVFILT_WRITE Takes a descriptor as the identifier, and returns whenever -it is possible to write to the descriptor. For sockets, pipes -and fifos, +it is possible to write to the descriptor. +For sockets, pipes, and fifos, .Va data will contain the amount of space remaining in the write buffer. -The filter will set EV_EOF when the reader disconnects, and for -the fifo case, this may be cleared by use of EV_CLEAR. +The filter will set +.Dv EV_EOF +when the reader disconnects, and for the fifo case, +this may be cleared by use of +.Dv EV_CLEAR . Note that this filter is not supported for vnodes. .Pp For sockets, the low water mark and socket error handling is -identical to the EVFILT_READ case. -.It EVFILT_AIO +identical to the +.Dv EVFILT_READ +case. +.It Dv EVFILT_AIO The sigevent portion of the AIO request is filled in, with .Va sigev_notify_kqueue containing the descriptor of the kqueue that the event should @@ -270,12 +290,13 @@ be attached to, .Va sigev_value containing the udata value, and .Va sigev_notify -set to SIGEV_EVENT. +set to +.Dv SIGEV_EVENT . When the aio_* function is called, the event will be registered with the specified kqueue, and the .Va ident argument set to the -.Fa struct aiocb +.Li struct aiocb returned by the aio_* function. The filter returns under the same conditions as aio_error. .Pp @@ -284,28 +305,29 @@ Alternatively, a kevent structure may be initialized, with containing the descriptor of the kqueue, and the address of the kevent structure placed in the .Va aio_lio_opcode -field of the AIO request. However, this approach will not work on -architectures with 64-bit pointers, and should be considered depreciated. -.It EVFILT_VNODE +field of the AIO request. +However, this approach will not work on architectures with 64-bit pointers, +and should be considered depreciated. +.It Dv EVFILT_VNODE Takes a file descriptor as the identifier and the events to watch for in .Va fflags , and returns when one or more of the requested events occurs on the descriptor. The events to monitor are: .Bl -tag -width XXNOTE_RENAME -.It NOTE_DELETE +.It Dv NOTE_DELETE .Fn unlink was called on the file referenced by the descriptor. -.It NOTE_WRITE +.It Dv NOTE_WRITE A write occurred on the file referenced by the descriptor. -.It NOTE_EXTEND +.It Dv NOTE_EXTEND The file referenced by the descriptor was extended. -.It NOTE_ATTRIB +.It Dv NOTE_ATTRIB The file referenced by the descriptor had its attributes changed. -.It NOTE_LINK +.It Dv NOTE_LINK The link count on the file changed. -.It NOTE_RENAME +.It Dv NOTE_RENAME The file referenced by the descriptor was renamed. -.It NOTE_REVOKE +.It Dv NOTE_REVOKE Access to the file was revoked via .Xr revoke 2 or the underlying fileystem was unmounted. @@ -314,7 +336,7 @@ or the underlying fileystem was unmounted. On return, .Va fflags contains the events which triggered the filter. -.It EVFILT_PROC +.It Dv EVFILT_PROC Takes the process ID to monitor as the identifier and the events to watch for in .Va fflags , @@ -322,25 +344,30 @@ and returns when the process performs one or more of the requested events. If a process can normally see another process, it can attach an event to it. The events to monitor are: .Bl -tag -width XXNOTE_TRACKERR -.It NOTE_EXIT +.It Dv NOTE_EXIT The process has exited. -.It NOTE_FORK +.It Dv NOTE_FORK The process has called .Fn fork . -.It NOTE_EXEC +.It Dv NOTE_EXEC The process has executed a new process via .Xr execve 2 or similar call. -.It NOTE_TRACK +.It Dv NOTE_TRACK Follow a process across .Fn fork -calls. The parent process will return with NOTE_TRACK set in the +calls. +The parent process will return with +.Dv NOTE_TRACK +set in the .Va fflags -field, while the child process will return with NOTE_CHILD set in +field, while the child process will return with +.Dv NOTE_CHILD +set in .Va fflags and the parent PID in .Va data . -.It NOTE_TRACKERR +.It Dv NOTE_TRACKERR This flag is returned if the system was unable to attach an event to the child process, usually due to resource limitations. .El @@ -348,21 +375,24 @@ the child process, usually due to resource limitations. On return, .Va fflags contains the events which triggered the filter. -.It EVFILT_SIGNAL +.It Dv EVFILT_SIGNAL Takes the signal number to monitor as the identifier and returns when the given signal is delivered to the process. This coexists with the .Fn signal and .Fn sigaction -facilities, and has a lower precedence. The filter will record -all attempts to deliver a signal to a process, even if the signal has -been marked as SIG_IGN. Event notification happens after normal -signal delivery processing. +facilities, and has a lower precedence. +The filter will record all attempts to deliver a signal to a process, +even if the signal has been marked as +.Dv SIG_IGN . +Event notification happens after normal signal delivery processing. .Va data returns the number of times the signal has occurred since the last call to .Fn kqueue . -This filter automatically sets the EV_CLEAR flag internally. +This filter automatically sets the +.Dv EV_CLEAR +flag internally. .El .Sh RETURN VALUES .Fn kqueue @@ -417,7 +447,7 @@ The process does not have permission to register a filter. .It Bq Er EFAULT There was an error reading or writing the .Va kevent -structure. +structure. .It Bq Er EBADF The specified descriptor is invalid. .It Bq Er EINTR @@ -452,5 +482,5 @@ The system and this manual page were written by .An Jonathan Lemon Aq jlemon@FreeBSD.org . .Sh BUGS -It is currently not possible to watch fifos, AIO or a vnode that +It is currently not possible to watch fifos, AIO, or a vnode that resides on anything but a UFS file system. diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2 index 63db0eac438..7ba36cfc6e7 100644 --- a/lib/libc/sys/sigaction.2 +++ b/lib/libc/sys/sigaction.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sigaction.2,v 1.26 2001/01/17 19:20:06 deraadt Exp $ +.\" $OpenBSD: sigaction.2,v 1.27 2001/03/11 05:02:30 aaron Exp $ .\" $NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $ .\" .\" Copyright (c) 1980, 1990, 1993 @@ -438,8 +438,9 @@ signal-catching functions: .Ed .Pp All functions not in the above list are considered to be unsafe -with respect to signals. That is to say, the behaviour of such -functions when called from a signal handler is undefined. +with respect to signals. +That is to say, the behaviour of such functions when called from +a signal handler is undefined. In general though, signal handlers should do little more than set a flag; most other actions are not safe. .Pp @@ -682,8 +683,9 @@ Extension Interfaces: .Fn strlcat . .Pp All functions not in the above lists are considered to be unsafe -with respect to signals. That is to say, the behaviour of such -functions when called from a signal handler is undefined. +with respect to signals. +That is to say, the behaviour of such functions when called from +a signal handler is undefined. .Pp As well, inside the signal handler it is also considered more safe to make a copy the global variable |