mirror of https://github.com/mkerrisk/man-pages
Adding section numbers to xrefs toother pages
This commit is contained in:
parent
63f6a20a1a
commit
fb18673428
|
@ -51,7 +51,7 @@ New severity classes can also be added by setting the environment variable
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
This function is not specified in the X/Open Portability Guide
|
This function is not specified in the X/Open Portability Guide
|
||||||
although the
|
although the
|
||||||
.BR fmtmsg ()
|
.BR fmtmsg (3)
|
||||||
function is.
|
function is.
|
||||||
It is available on System V
|
It is available on System V
|
||||||
systems.
|
systems.
|
||||||
|
|
|
@ -30,7 +30,7 @@ adjtime \- correct the time to synchronise the system clock
|
||||||
The
|
The
|
||||||
.BR adjtime ()
|
.BR adjtime ()
|
||||||
function gradually adjusts the system clock (as returned by
|
function gradually adjusts the system clock (as returned by
|
||||||
.BR gettimeofday ()).
|
.BR gettimeofday (2)).
|
||||||
The amount of time by which the clock is to be adjusted is specified
|
The amount of time by which the clock is to be adjusted is specified
|
||||||
in the structure pointed to by
|
in the structure pointed to by
|
||||||
.IR delta .
|
.IR delta .
|
||||||
|
|
|
@ -39,9 +39,9 @@ The functions
|
||||||
and
|
and
|
||||||
.BR vasprintf ()
|
.BR vasprintf ()
|
||||||
are analogues of
|
are analogues of
|
||||||
.BR sprintf ()
|
.BR sprintf (3)
|
||||||
and
|
and
|
||||||
.BR vsprintf (),
|
.BR vsprintf (3),
|
||||||
except that they allocate a string large enough to hold the output
|
except that they allocate a string large enough to hold the output
|
||||||
including the terminating null byte,
|
including the terminating null byte,
|
||||||
and return a pointer to it via the first parameter.
|
and return a pointer to it via the first parameter.
|
||||||
|
|
|
@ -43,7 +43,7 @@ Otherwise, the macro
|
||||||
.BR assert ()
|
.BR assert ()
|
||||||
prints an error message to standard error and terminates the program
|
prints an error message to standard error and terminates the program
|
||||||
by calling
|
by calling
|
||||||
.BR abort ()
|
.BR abort (3)
|
||||||
if
|
if
|
||||||
.I expression
|
.I expression
|
||||||
is false (i.e., compares equal to zero).
|
is false (i.e., compares equal to zero).
|
||||||
|
|
|
@ -45,7 +45,7 @@ Otherwise, the macro
|
||||||
.BR assert_perror ()
|
.BR assert_perror ()
|
||||||
prints an error message to standard error and terminates the program
|
prints an error message to standard error and terminates the program
|
||||||
by calling
|
by calling
|
||||||
.BR abort ()
|
.BR abort (3)
|
||||||
if
|
if
|
||||||
.I errnum
|
.I errnum
|
||||||
is non-zero.
|
is non-zero.
|
||||||
|
|
|
@ -51,7 +51,7 @@ The actual limit supported by an implementation can be obtained using
|
||||||
.BR sysconf (3).
|
.BR sysconf (3).
|
||||||
.LP
|
.LP
|
||||||
When a child process is created via
|
When a child process is created via
|
||||||
.BR fork (),
|
.BR fork (2),
|
||||||
it inherits copies of its parents registrations.
|
it inherits copies of its parents registrations.
|
||||||
Upon a successful call to one of the
|
Upon a successful call to one of the
|
||||||
.BR exec ()
|
.BR exec ()
|
||||||
|
@ -90,11 +90,11 @@ main(void)
|
||||||
}
|
}
|
||||||
.fi
|
.fi
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
Since glibc 2.2.3, \fBatexit\fP() (and \fBon_exit\fP())
|
Since glibc 2.2.3, \fBatexit\fP() (and \fBon_exit\fP(3))
|
||||||
can be used to within a shared library to establish functions
|
can be used to within a shared library to establish functions
|
||||||
that are called when the shared library is unloaded.
|
that are called when the shared library is unloaded.
|
||||||
.PP
|
.PP
|
||||||
Functions registered using \fBatexit\fP() (and \fBon_exit\fP())
|
Functions registered using \fBatexit\fP() (and \fBon_exit\fP(3))
|
||||||
are not called if a process terminates abnormally because
|
are not called if a process terminates abnormally because
|
||||||
of the delivery of a signal.
|
of the delivery of a signal.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -59,7 +59,7 @@ otherwise a non-zero result is returned.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
4.3BSD.
|
4.3BSD.
|
||||||
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
|
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
|
||||||
.BR memcmp ()
|
.BR memcmp (3)
|
||||||
in new programs.
|
in new programs.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR memcmp (3),
|
.BR memcmp (3),
|
||||||
|
|
|
@ -52,15 +52,15 @@ None.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
4.3BSD.
|
4.3BSD.
|
||||||
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
|
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
|
||||||
.BR memcpy ()
|
.BR memcpy (3)
|
||||||
or
|
or
|
||||||
.BR memmove ()
|
.BR memmove (3)
|
||||||
in new programs.
|
in new programs.
|
||||||
Note that the first two parameters
|
Note that the first two parameters
|
||||||
are interchanged for
|
are interchanged for
|
||||||
.BR memcpy ()
|
.BR memcpy (3)
|
||||||
and
|
and
|
||||||
.BR memmove ().
|
.BR memmove (3).
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR memccpy (3),
|
.BR memccpy (3),
|
||||||
.BR memcpy (3),
|
.BR memcpy (3),
|
||||||
|
|
|
@ -44,7 +44,7 @@ btree \- btree database access method
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The routine
|
The routine
|
||||||
.BR dbopen ()
|
.BR dbopen (3)
|
||||||
is the library interface to database files.
|
is the library interface to database files.
|
||||||
One of the supported file formats is btree files.
|
One of the supported file formats is btree files.
|
||||||
The general description of the database access methods is in
|
The general description of the database access methods is in
|
||||||
|
@ -55,7 +55,7 @@ The btree data structure is a sorted, balanced tree structure storing
|
||||||
associated key/data pairs.
|
associated key/data pairs.
|
||||||
.PP
|
.PP
|
||||||
The btree access method specific data structure provided to
|
The btree access method specific data structure provided to
|
||||||
.BR dbopen ()
|
.BR dbopen (3)
|
||||||
is defined in the <db.h> include file as follows:
|
is defined in the <db.h> include file as follows:
|
||||||
.PP
|
.PP
|
||||||
typedef struct {
|
typedef struct {
|
||||||
|
|
|
@ -48,7 +48,7 @@ None.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
4.3BSD.
|
4.3BSD.
|
||||||
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
|
This function is deprecated (marked as LEGACY in POSIX.1-2001): use
|
||||||
.BR memset ()
|
.BR memset (3)
|
||||||
in new programs.
|
in new programs.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR memset (3),
|
.BR memset (3),
|
||||||
|
|
|
@ -39,7 +39,7 @@ opens a message catalog and returns a catalog descriptor.
|
||||||
The descriptor remains valid until
|
The descriptor remains valid until
|
||||||
.BR catclose ()
|
.BR catclose ()
|
||||||
or
|
or
|
||||||
.BR exec ().
|
.BR execve (2).
|
||||||
If a file descriptor is used to implement catalog descriptors
|
If a file descriptor is used to implement catalog descriptors
|
||||||
then the FD_CLOEXEC flag will be set.
|
then the FD_CLOEXEC flag will be set.
|
||||||
.LP
|
.LP
|
||||||
|
@ -115,7 +115,7 @@ and sets
|
||||||
to indicate the error.
|
to indicate the error.
|
||||||
The possible error values include all
|
The possible error values include all
|
||||||
possible values for the
|
possible values for the
|
||||||
.BR open ()
|
.BR open (2)
|
||||||
call.
|
call.
|
||||||
.LP
|
.LP
|
||||||
The function
|
The function
|
||||||
|
@ -145,7 +145,7 @@ These functions are available for Linux since libc 4.4.4c.
|
||||||
In the case of linux libc4 and libc5, the catalog descriptor
|
In the case of linux libc4 and libc5, the catalog descriptor
|
||||||
.I nl_catd
|
.I nl_catd
|
||||||
is a
|
is a
|
||||||
.BR mmap ()'ed
|
.BR mmap (2)'ed
|
||||||
area of memory and not a file descriptor.
|
area of memory and not a file descriptor.
|
||||||
The
|
The
|
||||||
.I flag
|
.I flag
|
||||||
|
|
|
@ -72,13 +72,13 @@ If you need it while porting something, add
|
||||||
to your file.
|
to your file.
|
||||||
.LP
|
.LP
|
||||||
A frequently asked question is "Can I use
|
A frequently asked question is "Can I use
|
||||||
.BR free ()
|
.BR free (3)
|
||||||
to free memory allocated with
|
to free memory allocated with
|
||||||
.BR calloc (),
|
.BR calloc (3),
|
||||||
or do I need
|
or do I need
|
||||||
.BR cfree ()?"
|
.BR cfree ()?"
|
||||||
Answer: use
|
Answer: use
|
||||||
.BR free ().
|
.BR free (3).
|
||||||
.LP
|
.LP
|
||||||
An SCO manual writes: "The cfree routine is provided for compliance
|
An SCO manual writes: "The cfree routine is provided for compliance
|
||||||
to the iBCSe2 standard and simply calls free.
|
to the iBCSe2 standard and simply calls free.
|
||||||
|
@ -88,7 +88,7 @@ arguments to cfree are not used."
|
||||||
The SunOS version of
|
The SunOS version of
|
||||||
.BR cfree ()
|
.BR cfree ()
|
||||||
(which is a synonym for
|
(which is a synonym for
|
||||||
.BR free ())
|
.BR free (3))
|
||||||
returns 1 on success and 0 on failure.
|
returns 1 on success and 0 on failure.
|
||||||
In case of error,
|
In case of error,
|
||||||
.I errno
|
.I errno
|
||||||
|
|
|
@ -46,11 +46,11 @@ In glibc since glibc 2.0.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
Various Unix variants (DG/UX, HP-UX, QNX, ...).
|
Various Unix variants (DG/UX, HP-UX, QNX, ...).
|
||||||
POSIX.9 (bindings for FORTRAN77).
|
POSIX.9 (bindings for FORTRAN77).
|
||||||
POSIX.1-1996 did not accept \fBclearenv\fP() and \fIputenv\fP(),
|
POSIX.1-1996 did not accept \fBclearenv\fP() and \fIputenv\fP(3),
|
||||||
but changed its mind and scheduled these functions for some
|
but changed its mind and scheduled these functions for some
|
||||||
later issue of this standard (cf. B.4.6.1).
|
later issue of this standard (cf. B.4.6.1).
|
||||||
However, POSIX.1-2001
|
However, POSIX.1-2001
|
||||||
only adds \fIputenv\fP(), and rejected \fBclearenv\fP().
|
only adds \fIputenv\fP(3), and rejected \fBclearenv\fP().
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
Used in security-conscious applications.
|
Used in security-conscious applications.
|
||||||
If it is unavailable
|
If it is unavailable
|
||||||
|
@ -65,8 +65,8 @@ will probably do.
|
||||||
The DG/UX and Tru64 manpages write: If
|
The DG/UX and Tru64 manpages write: If
|
||||||
.I environ
|
.I environ
|
||||||
has been modified by anything other than the
|
has been modified by anything other than the
|
||||||
.BR putenv (),
|
.BR putenv (3),
|
||||||
.BR getenv (),
|
.BR getenv (3),
|
||||||
or
|
or
|
||||||
.BR clearenv ()
|
.BR clearenv ()
|
||||||
functions, then
|
functions, then
|
||||||
|
|
|
@ -64,7 +64,7 @@ the value returned by
|
||||||
.BR clock ()
|
.BR clock ()
|
||||||
also includes the times of any children whose status has been
|
also includes the times of any children whose status has been
|
||||||
collected via
|
collected via
|
||||||
.BR wait ()
|
.BR wait (2)
|
||||||
(or another wait-type call).
|
(or another wait-type call).
|
||||||
Linux does not include the times of waited-for children in the
|
Linux does not include the times of waited-for children in the
|
||||||
value returned by
|
value returned by
|
||||||
|
@ -74,7 +74,7 @@ value returned by
|
||||||
.\" POSIX.1-2001 doesn't explicitly allow this, nor is there an
|
.\" POSIX.1-2001 doesn't explicitly allow this, nor is there an
|
||||||
.\" explicit prohibition. -- MTK
|
.\" explicit prohibition. -- MTK
|
||||||
The
|
The
|
||||||
.BR times ()
|
.BR times (2)
|
||||||
function, which explicitly returns (separate) information about the
|
function, which explicitly returns (separate) information about the
|
||||||
caller and its children, may be preferable.
|
caller and its children, may be preferable.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -58,7 +58,7 @@ will redirect standard input, standard output and standard error
|
||||||
to \fI/dev/null\fP.
|
to \fI/dev/null\fP.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
(This function forks, and if the
|
(This function forks, and if the
|
||||||
.BR fork ()
|
.BR fork (2)
|
||||||
succeeds, the parent does
|
succeeds, the parent does
|
||||||
.\" not .IR in order not to underline _
|
.\" not .IR in order not to underline _
|
||||||
.BR _exit (0),
|
.BR _exit (0),
|
||||||
|
|
|
@ -39,9 +39,9 @@ The functions
|
||||||
and
|
and
|
||||||
.BR vdprintf ()
|
.BR vdprintf ()
|
||||||
(as found in the glibc2 library) are exact analogues of
|
(as found in the glibc2 library) are exact analogues of
|
||||||
.BR fprintf ()
|
.BR fprintf (3)
|
||||||
and
|
and
|
||||||
.BR vfprintf (),
|
.BR vfprintf (3),
|
||||||
except that they output to a file descriptor
|
except that they output to a file descriptor
|
||||||
.I fd
|
.I fd
|
||||||
instead of to a given stream.
|
instead of to a given stream.
|
||||||
|
@ -51,7 +51,7 @@ Clearly, the names were badly chosen.
|
||||||
Many systems (like MacOS) have incompatible functions called
|
Many systems (like MacOS) have incompatible functions called
|
||||||
.BR dprintf (),
|
.BR dprintf (),
|
||||||
usually some debugging version of
|
usually some debugging version of
|
||||||
.BR printf (),
|
.BR printf (3),
|
||||||
perhaps with a prototype like
|
perhaps with a prototype like
|
||||||
|
|
||||||
.BI "void dprintf(int level, const char *" format ", ...);"
|
.BI "void dprintf(int level, const char *" format ", ...);"
|
||||||
|
@ -67,7 +67,7 @@ So, probably, it is better to avoid this function in programs
|
||||||
intended to be portable.
|
intended to be portable.
|
||||||
|
|
||||||
A better name would have been
|
A better name would have been
|
||||||
.BR fdprintf ().
|
.BR fdprintf (3).
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
These functions are GNU extensions.
|
These functions are GNU extensions.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -69,7 +69,7 @@ The static string is overwritten by each call to \fBecvt\fP() or
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
These functions are obsolete.
|
These functions are obsolete.
|
||||||
Instead,
|
Instead,
|
||||||
.BR sprintf ()
|
.BR sprintf (3)
|
||||||
is recommended.
|
is recommended.
|
||||||
Linux libc4 and libc5 specified the type of
|
Linux libc4 and libc5 specified the type of
|
||||||
.I ndigits
|
.I ndigits
|
||||||
|
|
|
@ -71,7 +71,7 @@ These functions return 0 on success, and \-1 otherwise.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
These functions are obsolete.
|
These functions are obsolete.
|
||||||
Instead,
|
Instead,
|
||||||
.BR sprintf ()
|
.BR sprintf (3)
|
||||||
is recommended.
|
is recommended.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
These functions are GNU extensions.
|
These functions are GNU extensions.
|
||||||
|
|
|
@ -482,7 +482,7 @@ where
|
||||||
no longer needs to have the value it had upon return from
|
no longer needs to have the value it had upon return from
|
||||||
.IR somecall ()
|
.IR somecall ()
|
||||||
(i.e., it may have been changed by the
|
(i.e., it may have been changed by the
|
||||||
.BR printf ()).
|
.BR printf (3)).
|
||||||
If the value of
|
If the value of
|
||||||
.I errno
|
.I errno
|
||||||
should be preserved across a library call, it must be saved:
|
should be preserved across a library call, it must be saved:
|
||||||
|
|
|
@ -35,12 +35,12 @@ euidaccess, eaccess \- check effective user's permissions for a file
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
Like
|
Like
|
||||||
.BR access (),
|
.BR access (2),
|
||||||
.BR euidaccess ()
|
.BR euidaccess ()
|
||||||
checks permissions and existence of the file identified by its argument
|
checks permissions and existence of the file identified by its argument
|
||||||
.IR pathname .
|
.IR pathname .
|
||||||
However, whereas
|
However, whereas
|
||||||
.BR access (),
|
.BR access (2),
|
||||||
performs checks using the real user and group identifiers of the process,
|
performs checks using the real user and group identifiers of the process,
|
||||||
.BR euidaccess ()
|
.BR euidaccess ()
|
||||||
uses the effective identifiers.
|
uses the effective identifiers.
|
||||||
|
@ -49,7 +49,7 @@ uses the effective identifiers.
|
||||||
is a mask consisting of one or more of
|
is a mask consisting of one or more of
|
||||||
.BR R_OK ", " W_OK ", " X_OK " and " F_OK ,
|
.BR R_OK ", " W_OK ", " X_OK " and " F_OK ,
|
||||||
with the same meanings as for
|
with the same meanings as for
|
||||||
.BR access ().
|
.BR access (2).
|
||||||
|
|
||||||
.BR eaccess ()
|
.BR eaccess ()
|
||||||
is a synonym for
|
is a synonym for
|
||||||
|
@ -65,7 +65,7 @@ asked for a permission that is denied, or some other error occurred),
|
||||||
is set appropriately.
|
is set appropriately.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
As for
|
As for
|
||||||
.BR access ().
|
.BR access (2).
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
These functions are non-standard.
|
These functions are non-standard.
|
||||||
Some other systems have an
|
Some other systems have an
|
||||||
|
|
|
@ -64,7 +64,7 @@ The functions described in this manual page are front-ends for the
|
||||||
function
|
function
|
||||||
.BR execve (2).
|
.BR execve (2).
|
||||||
(See the manual page for
|
(See the manual page for
|
||||||
.BR execve ()
|
.BR execve (2)
|
||||||
for detailed information about the replacement of the current process.)
|
for detailed information about the replacement of the current process.)
|
||||||
.PP
|
.PP
|
||||||
The initial argument for these functions is the pathname of a file which is
|
The initial argument for these functions is the pathname of a file which is
|
||||||
|
|
12
man3/exit.3
12
man3/exit.3
|
@ -36,16 +36,16 @@ value of \fIstatus & 0377\fP is returned to the parent
|
||||||
.BR wait (2)).
|
.BR wait (2)).
|
||||||
.LP
|
.LP
|
||||||
All functions registered with
|
All functions registered with
|
||||||
\fBatexit\fP() and \fBon_exit\fP()
|
\fBatexit\fP(3) and \fBon_exit\fP(3)
|
||||||
are called, in the reverse order of their registration.
|
are called, in the reverse order of their registration.
|
||||||
(It is possible for one of these functions to use
|
(It is possible for one of these functions to use
|
||||||
\fBatexit\fP() or \fBon_exit\fP() to register an additional
|
\fBatexit\fP(3) or \fBon_exit\fP(3) to register an additional
|
||||||
function to be executed during exit processing;
|
function to be executed during exit processing;
|
||||||
the new registration is added to the front of the list of functions
|
the new registration is added to the front of the list of functions
|
||||||
that remain to be called.)
|
that remain to be called.)
|
||||||
.LP
|
.LP
|
||||||
All open streams are flushed and closed.
|
All open streams are flushed and closed.
|
||||||
Files created by \fBtmpfile\fP() are removed.
|
Files created by \fBtmpfile\fP(3) are removed.
|
||||||
.LP
|
.LP
|
||||||
The C standard specifies two constants,
|
The C standard specifies two constants,
|
||||||
\fIEXIT_SUCCESS\fP and \fIEXIT_FAILURE\fP,
|
\fIEXIT_SUCCESS\fP and \fIEXIT_FAILURE\fP,
|
||||||
|
@ -58,8 +58,8 @@ SVr4, 4.3BSD, POSIX.1-2001, C89, C99.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
.LP
|
.LP
|
||||||
It is undefined what happens if one of the
|
It is undefined what happens if one of the
|
||||||
functions registered using \fBatexit\fP() and \fBon_exit\fP()
|
functions registered using \fBatexit\fP(3) and \fBon_exit\fP(3)
|
||||||
calls either \fBexit\fP() or \fBlongjmp\fP().
|
calls either \fBexit\fP() or \fBlongjmp\fP(3).
|
||||||
.LP
|
.LP
|
||||||
The use of EXIT_SUCCESS and EXIT_FAILURE is slightly more portable
|
The use of EXIT_SUCCESS and EXIT_FAILURE is slightly more portable
|
||||||
(to non-Unix environments) than that of 0 and some non-zero value
|
(to non-Unix environments) than that of 0 and some non-zero value
|
||||||
|
@ -84,7 +84,7 @@ it is not interested in the exit status, but is not waiting,
|
||||||
the exiting process turns into a "zombie" process
|
the exiting process turns into a "zombie" process
|
||||||
(which is nothing but a container for the single byte representing
|
(which is nothing but a container for the single byte representing
|
||||||
the exit status) so that the parent can learn the exit status when
|
the exit status) so that the parent can learn the exit status when
|
||||||
it later calls one of the \fIwait\fP() functions.
|
it later calls one of the \fIwait\fP(2) functions.
|
||||||
.LP
|
.LP
|
||||||
If the implementation supports the SIGCHLD signal, this signal
|
If the implementation supports the SIGCHLD signal, this signal
|
||||||
is sent to the parent.
|
is sent to the parent.
|
||||||
|
|
|
@ -42,8 +42,8 @@ There is no reason ever to use it.
|
||||||
For non-locking counterparts, see
|
For non-locking counterparts, see
|
||||||
.BR unlocked_stdio (3).
|
.BR unlocked_stdio (3).
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The \fBfgetwc\fP() function returns the next wide-character from the stream, or
|
The \fBfgetwc\fP() function returns the next wide-character
|
||||||
WEOF.
|
from the stream, or WEOF.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
Apart from the usual ones, there is
|
Apart from the usual ones, there is
|
||||||
.TP
|
.TP
|
||||||
|
@ -57,7 +57,7 @@ The behaviour of \fBfgetwc\fP() depends on the LC_CTYPE category of the
|
||||||
current locale.
|
current locale.
|
||||||
.PP
|
.PP
|
||||||
In the absence of additional information passed to the
|
In the absence of additional information passed to the
|
||||||
.BR fopen ()
|
.BR fopen (3)
|
||||||
call, it is
|
call, it is
|
||||||
reasonable to expect that \fBfgetwc\fP()
|
reasonable to expect that \fBfgetwc\fP()
|
||||||
will actually read a multibyte sequence
|
will actually read a multibyte sequence
|
||||||
|
|
|
@ -47,7 +47,7 @@ The behaviour of \fBfgetws\fP() depends on the LC_CTYPE category of the
|
||||||
current locale.
|
current locale.
|
||||||
.PP
|
.PP
|
||||||
In the absence of additional information passed to the
|
In the absence of additional information passed to the
|
||||||
.BR fopen ()
|
.BR fopen (3)
|
||||||
call, it is
|
call, it is
|
||||||
reasonable to expect that \fBfgetws\fP()
|
reasonable to expect that \fBfgetws\fP()
|
||||||
will actually read a multibyte string
|
will actually read a multibyte string
|
||||||
|
|
|
@ -63,8 +63,8 @@ other threads from coming in between.
|
||||||
If the reason for doing
|
If the reason for doing
|
||||||
this was to achieve greater efficiency, one does the I/O with
|
this was to achieve greater efficiency, one does the I/O with
|
||||||
the non-locking versions of the stdio functions: with
|
the non-locking versions of the stdio functions: with
|
||||||
\fIgetc_unlocked\fP() and \fIputc_unlocked\fP() instead of
|
\fIgetc_unlocked\fP(3) and \fIputc_unlocked\fP(3) instead of
|
||||||
\fIgetc\fP() and \fIputc\fP().
|
\fIgetc\fP(3) and \fIputc\fP(3).
|
||||||
.LP
|
.LP
|
||||||
The \fBflockfile\fP() function waits for *\fIfilehandle\fP to be
|
The \fBflockfile\fP() function waits for *\fIfilehandle\fP to be
|
||||||
no longer locked by a different thread, then makes the
|
no longer locked by a different thread, then makes the
|
||||||
|
|
|
@ -139,7 +139,7 @@ This value is printed as INFO.
|
||||||
.PP
|
.PP
|
||||||
The numeric values are between 0 and 4.
|
The numeric values are between 0 and 4.
|
||||||
Using
|
Using
|
||||||
.BR addseverity ()
|
.BR addseverity (3)
|
||||||
or the environment variable
|
or the environment variable
|
||||||
.B SEV_LEVEL
|
.B SEV_LEVEL
|
||||||
you can add more levels and strings to print.
|
you can add more levels and strings to print.
|
||||||
|
@ -217,7 +217,7 @@ Error writing to the console.
|
||||||
The functions
|
The functions
|
||||||
.BR fmtmsg ()
|
.BR fmtmsg ()
|
||||||
and
|
and
|
||||||
.BR addseverity (),
|
.BR addseverity (3),
|
||||||
and environment variables
|
and environment variables
|
||||||
.B MSGVERB
|
.B MSGVERB
|
||||||
and
|
and
|
||||||
|
|
|
@ -116,9 +116,9 @@ between output and input, unless an input operation encounters end-of-file.
|
||||||
result of writes other than the most recent.)
|
result of writes other than the most recent.)
|
||||||
Therefore it is good practice (and indeed sometimes necessary
|
Therefore it is good practice (and indeed sometimes necessary
|
||||||
under Linux) to put an
|
under Linux) to put an
|
||||||
.BR fseek ()
|
.BR fseek (3)
|
||||||
or
|
or
|
||||||
.BR fgetpos ()
|
.BR fgetpos (3)
|
||||||
operation between write and read operations on such a stream.
|
operation between write and read operations on such a stream.
|
||||||
This operation may be an apparent no-op (as in \fIfseek(..., 0L,
|
This operation may be an apparent no-op (as in \fIfseek(..., 0L,
|
||||||
SEEK_CUR)\fR called for its synchronizing side effect.
|
SEEK_CUR)\fR called for its synchronizing side effect.
|
||||||
|
|
|
@ -45,7 +45,7 @@ For output streams this discards any unwritten output.
|
||||||
For input streams this discards any input read from the underlying object
|
For input streams this discards any input read from the underlying object
|
||||||
but not yet obtained via
|
but not yet obtained via
|
||||||
.BR getc (3);
|
.BR getc (3);
|
||||||
this includes any text pushed back via \fIungetc\fP(). See also
|
this includes any text pushed back via \fIungetc\fP(3). See also
|
||||||
.BR fflush (3).
|
.BR fflush (3).
|
||||||
.LP
|
.LP
|
||||||
The function
|
The function
|
||||||
|
|
|
@ -55,7 +55,7 @@ The behaviour of \fBfputwc\fP() depends on the LC_CTYPE category of the
|
||||||
current locale.
|
current locale.
|
||||||
.PP
|
.PP
|
||||||
In the absence of additional information passed to the
|
In the absence of additional information passed to the
|
||||||
.BR fopen ()
|
.BR fopen (3)
|
||||||
call, it is
|
call, it is
|
||||||
reasonable to expect that \fBfputwc\fP() will actually write the multibyte
|
reasonable to expect that \fBfputwc\fP() will actually write the multibyte
|
||||||
sequence corresponding to the wide character \fIwc\fP.
|
sequence corresponding to the wide character \fIwc\fP.
|
||||||
|
|
|
@ -39,7 +39,7 @@ The behaviour of \fBfputws\fP() depends on the LC_CTYPE category of the
|
||||||
current locale.
|
current locale.
|
||||||
.PP
|
.PP
|
||||||
In the absence of additional information passed to the
|
In the absence of additional information passed to the
|
||||||
.BR fopen ()
|
.BR fopen (3)
|
||||||
call, it is
|
call, it is
|
||||||
reasonable to expect that \fBfputws\fP() will actually write the multibyte
|
reasonable to expect that \fBfputws\fP() will actually write the multibyte
|
||||||
string corresponding to the wide-character string \fIws\fP.
|
string corresponding to the wide-character string \fIws\fP.
|
||||||
|
|
|
@ -34,7 +34,7 @@ fseeko, ftello \- seek to or report file position
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBfseeko\fP() and \fBftello\fP() functions are identical to
|
The \fBfseeko\fP() and \fBftello\fP() functions are identical to
|
||||||
\fBfseek\fP() and \fBftell\fP() (see
|
\fBfseek\fP(3) and \fBftell\fP(3) (see
|
||||||
.BR fseek (3)),
|
.BR fseek (3)),
|
||||||
respectively, except that the \fIoffset\fP argument of \fBfseeko\fP()
|
respectively, except that the \fIoffset\fP argument of \fBfseeko\fP()
|
||||||
and the return value of \fBftello\fP() is of type \fIoff_t\fP
|
and the return value of \fBftello\fP() is of type \fIoff_t\fP
|
||||||
|
|
|
@ -56,7 +56,7 @@ C99, POSIX.1-2001.
|
||||||
.BR fwprintf (3)
|
.BR fwprintf (3)
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
Wide-character output to a byte oriented stream can be performed through the
|
Wide-character output to a byte oriented stream can be performed through the
|
||||||
\fBfprintf\fP() function with the %lc and %ls directives.
|
\fBfprintf\fP(3) function with the %lc and %ls directives.
|
||||||
.PP
|
.PP
|
||||||
Char oriented output to a wide-character oriented stream can be performed
|
Char oriented output to a wide-character oriented stream can be performed
|
||||||
through the \fBfwprintf\fP() function with the %c and %s directives.
|
through the \fBfwprintf\fP(3) function with the %c and %s directives.
|
||||||
|
|
|
@ -43,7 +43,7 @@ F format or E format.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
This function is obsolete.
|
This function is obsolete.
|
||||||
Instead,
|
Instead,
|
||||||
.BR sprintf ()
|
.BR sprintf (3)
|
||||||
is recommended.
|
is recommended.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The \fBgcvt\fP() function returns the address of the string pointed to
|
The \fBgcvt\fP() function returns the address of the string pointed to
|
||||||
|
|
|
@ -73,7 +73,7 @@ is undefined.
|
||||||
As an extension to the POSIX.1-2001 standard, Linux (libc4, libc5, glibc)
|
As an extension to the POSIX.1-2001 standard, Linux (libc4, libc5, glibc)
|
||||||
.BR getcwd ()
|
.BR getcwd ()
|
||||||
allocates the buffer dynamically using
|
allocates the buffer dynamically using
|
||||||
.BR malloc ()
|
.BR malloc (3)
|
||||||
if
|
if
|
||||||
.I buf
|
.I buf
|
||||||
is NULL on call.
|
is NULL on call.
|
||||||
|
@ -86,7 +86,7 @@ is zero, when
|
||||||
is allocated as big as necessary.
|
is allocated as big as necessary.
|
||||||
It is possible (and, indeed,
|
It is possible (and, indeed,
|
||||||
advisable) to
|
advisable) to
|
||||||
.BR free ()
|
.BR free (3)
|
||||||
the buffers if they have been obtained this way.
|
the buffers if they have been obtained this way.
|
||||||
|
|
||||||
.BR get_current_dir_name (),
|
.BR get_current_dir_name (),
|
||||||
|
|
|
@ -141,7 +141,7 @@ values as given above for
|
||||||
.IR getdate_err .
|
.IR getdate_err .
|
||||||
.LP
|
.LP
|
||||||
The POSIX.1-2001 specification for
|
The POSIX.1-2001 specification for
|
||||||
.BR strptime ()
|
.BR strptime (3)
|
||||||
contains conversion specifications using the
|
contains conversion specifications using the
|
||||||
.B %E
|
.B %E
|
||||||
or
|
or
|
||||||
|
@ -151,7 +151,7 @@ modifier, while such specifications are not given for
|
||||||
The glibc implementation implements
|
The glibc implementation implements
|
||||||
.BR getdate ()
|
.BR getdate ()
|
||||||
using
|
using
|
||||||
.BR strptime ()
|
.BR strptime (3)
|
||||||
so that automatically precisely the same conversions are supported by both.
|
so that automatically precisely the same conversions are supported by both.
|
||||||
.LP
|
.LP
|
||||||
The glibc implementation does not support the
|
The glibc implementation does not support the
|
||||||
|
@ -163,7 +163,7 @@ conversion specification.
|
||||||
File containing format patterns.
|
File containing format patterns.
|
||||||
.TP
|
.TP
|
||||||
.BR TZ ", " LC_TIME
|
.BR TZ ", " LC_TIME
|
||||||
Variables used by \fBstrptime\fP().
|
Variables used by \fBstrptime\fP(3).
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
POSIX.1-2001
|
POSIX.1-2001
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -52,14 +52,14 @@ Alternatively, before calling
|
||||||
.BR getline (),
|
.BR getline (),
|
||||||
.IR "*lineptr"
|
.IR "*lineptr"
|
||||||
can contain a pointer to a
|
can contain a pointer to a
|
||||||
.BR malloc ()\-allocated
|
.BR malloc (3)\-allocated
|
||||||
buffer
|
buffer
|
||||||
.IR "*n"
|
.IR "*n"
|
||||||
bytes in size.
|
bytes in size.
|
||||||
If the buffer is not large enough to hold the line,
|
If the buffer is not large enough to hold the line,
|
||||||
.BR getline ()
|
.BR getline ()
|
||||||
resizes it with
|
resizes it with
|
||||||
.BR realloc (),
|
.BR realloc (3),
|
||||||
updating
|
updating
|
||||||
.IR "*lineptr"
|
.IR "*lineptr"
|
||||||
and
|
and
|
||||||
|
|
|
@ -80,7 +80,7 @@ The
|
||||||
function is dangerous as it may overflow the provided buffer
|
function is dangerous as it may overflow the provided buffer
|
||||||
.IR buf .
|
.IR buf .
|
||||||
It is obsoleted by
|
It is obsoleted by
|
||||||
.BR getpwuid ().
|
.BR getpwuid (3).
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR endpwent (3),
|
.BR endpwent (3),
|
||||||
.BR fgetpwent (3),
|
.BR fgetpwent (3),
|
||||||
|
|
|
@ -56,7 +56,7 @@ that might be passed in
|
||||||
The
|
The
|
||||||
.I tokens
|
.I tokens
|
||||||
argument is pointer to a NULL-terminated list of the tokens that
|
argument is pointer to a NULL-terminated list of the tokens that
|
||||||
.BR getsupobts ()
|
.BR getsubopt ()
|
||||||
will look for in
|
will look for in
|
||||||
.IR optionp .
|
.IR optionp .
|
||||||
The tokens should be distinct, null-terminated strings containing at
|
The tokens should be distinct, null-terminated strings containing at
|
||||||
|
|
|
@ -49,7 +49,7 @@ mode_t getumask(void)
|
||||||
.in -0.5i
|
.in -0.5i
|
||||||
except that it is documented to be thread-safe (that is, shares
|
except that it is documented to be thread-safe (that is, shares
|
||||||
a lock with the
|
a lock with the
|
||||||
.BR umask ()
|
.BR umask (2)
|
||||||
library call).
|
library call).
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
This function is documented but not implemented yet in glibc 2.2.5.
|
This function is documented but not implemented yet in glibc 2.2.5.
|
||||||
|
|
|
@ -120,9 +120,9 @@ The following example adds and removes a utmp record, assuming it is run
|
||||||
from within a pseudo terminal.
|
from within a pseudo terminal.
|
||||||
For usage in a real application, you
|
For usage in a real application, you
|
||||||
should check the return values of
|
should check the return values of
|
||||||
.BR getpwuid ()
|
.BR getpwuid (3)
|
||||||
and
|
and
|
||||||
.BR ttyname ().
|
.BR ttyname (3).
|
||||||
.PP
|
.PP
|
||||||
.nf
|
.nf
|
||||||
#include <string.h>
|
#include <string.h>
|
||||||
|
|
|
@ -23,7 +23,7 @@ getwchar \- read a wide character from standard input
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBgetwchar\fP() function is the wide-character equivalent of the
|
The \fBgetwchar\fP() function is the wide-character equivalent of the
|
||||||
\fBgetchar\fP() function.
|
\fBgetchar\fP(3) function.
|
||||||
It reads a wide character from \fBstdin\fP and returns
|
It reads a wide character from \fBstdin\fP and returns
|
||||||
it.
|
it.
|
||||||
If the end of stream is reached, or if \fIferror(stdin)\fP becomes
|
If the end of stream is reached, or if \fIferror(stdin)\fP becomes
|
||||||
|
@ -42,8 +42,9 @@ C99
|
||||||
The behaviour of \fBgetwchar\fP() depends on the LC_CTYPE category of the
|
The behaviour of \fBgetwchar\fP() depends on the LC_CTYPE category of the
|
||||||
current locale.
|
current locale.
|
||||||
.PP
|
.PP
|
||||||
It is reasonable to expect that \fBgetwchar\fP() will actually read a multibyte
|
It is reasonable to expect that \fBgetwchar\fP() will actually
|
||||||
sequence from standard input and then convert it to a wide character.
|
read a multibyte sequence from standard input and then
|
||||||
|
convert it to a wide character.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR fgetwc (3),
|
.BR fgetwc (3),
|
||||||
.BR unlocked_stdio (3)
|
.BR unlocked_stdio (3)
|
||||||
|
|
|
@ -38,9 +38,9 @@ gsignal, ssignal \- software signal facility
|
||||||
Don't use these functions under Linux.
|
Don't use these functions under Linux.
|
||||||
Due to a historical mistake, under Linux these functions are
|
Due to a historical mistake, under Linux these functions are
|
||||||
aliases for
|
aliases for
|
||||||
.BR raise ()
|
.BR raise (3)
|
||||||
and
|
and
|
||||||
.BR signal (),
|
.BR signal (2),
|
||||||
respectively.
|
respectively.
|
||||||
.LP
|
.LP
|
||||||
Elsewhere, on System V-like systems, these functions implement
|
Elsewhere, on System V-like systems, these functions implement
|
||||||
|
|
|
@ -40,7 +40,7 @@ These functions return the exponent part of their argument
|
||||||
as a signed integer.
|
as a signed integer.
|
||||||
When no error occurs, these functions
|
When no error occurs, these functions
|
||||||
are equivalent to the corresponding
|
are equivalent to the corresponding
|
||||||
.BR logb ()
|
.BR logb (3)
|
||||||
functions, cast to (int).
|
functions, cast to (int).
|
||||||
An error will occur for zero and infinity and NaN,
|
An error will occur for zero and infinity and NaN,
|
||||||
and possibly for overflow.
|
and possibly for overflow.
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswalpha \- test for alphabetic wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswalpha\fP() function is the wide-character equivalent of the
|
The \fBiswalpha\fP() function is the wide-character equivalent of the
|
||||||
\fBisalpha\fP() function.
|
\fBisalpha\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "alpha".
|
belonging to the wide-character class "alpha".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswblank \- test for whitespace wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswblank\fP() function is the wide-character equivalent of the
|
The \fBiswblank\fP() function is the wide-character equivalent of the
|
||||||
\fBisblank\fP() function.
|
\fBisblank\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "blank".
|
belonging to the wide-character class "blank".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswcntrl \- test for control wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswcntrl\fP() function is the wide-character equivalent of the
|
The \fBiswcntrl\fP() function is the wide-character equivalent of the
|
||||||
\fBiscntrl\fP() function.
|
\fBiscntrl\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "cntrl".
|
belonging to the wide-character class "cntrl".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswdigit \- test for decimal digit wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswdigit\fP() function is the wide-character equivalent of the
|
The \fBiswdigit\fP() function is the wide-character equivalent of the
|
||||||
\fBisdigit\fP() function.
|
\fBisdigit\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "digit".
|
belonging to the wide-character class "digit".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswgraph \- test for graphic wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswgraph\fP() function is the wide-character equivalent of the
|
The \fBiswgraph\fP() function is the wide-character equivalent of the
|
||||||
\fBisgraph\fP() function.
|
\fBisgraph\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "graph".
|
belonging to the wide-character class "graph".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswlower \- test for lowercase wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswlower\fP() function is the wide-character equivalent of the
|
The \fBiswlower\fP() function is the wide-character equivalent of the
|
||||||
\fBislower\fP() function.
|
\fBislower\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "lower".
|
belonging to the wide-character class "lower".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswprint \- test for printing wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswprint\fP() function is the wide-character equivalent of the
|
The \fBiswprint\fP() function is the wide-character equivalent of the
|
||||||
\fBisprint\fP() function.
|
\fBisprint\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "print".
|
belonging to the wide-character class "print".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswpunct \- test for punctuation or symbolic wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswpunct\fP() function is the wide-character equivalent of the
|
The \fBiswpunct\fP() function is the wide-character equivalent of the
|
||||||
\fBispunct\fP() function.
|
\fBispunct\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "punct".
|
belonging to the wide-character class "punct".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswspace \- test for whitespace wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswspace\fP() function is the wide-character equivalent of the
|
The \fBiswspace\fP() function is the wide-character equivalent of the
|
||||||
\fBisspace\fP() function.
|
\fBisspace\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "space".
|
belonging to the wide-character class "space".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswupper \- test for uppercase wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswupper\fP() function is the wide-character equivalent of the
|
The \fBiswupper\fP() function is the wide-character equivalent of the
|
||||||
\fBisupper\fP() function.
|
\fBisupper\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "upper".
|
belonging to the wide-character class "upper".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -22,7 +22,7 @@ iswxdigit \- test for hexadecimal digit wide character
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBiswxdigit\fP() function is the wide-character equivalent of the
|
The \fBiswxdigit\fP() function is the wide-character equivalent of the
|
||||||
\fBisxdigit\fP() function.
|
\fBisxdigit\fP(3) function.
|
||||||
It tests whether \fIwc\fP is a wide character
|
It tests whether \fIwc\fP is a wide character
|
||||||
belonging to the wide-character class "xdigit".
|
belonging to the wide-character class "xdigit".
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -51,7 +51,7 @@ which behave according to the actual locale in use.
|
||||||
C89, C99.
|
C89, C99.
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
The
|
The
|
||||||
.BR printf ()
|
.BR printf (3)
|
||||||
family of functions may or may not honor the current locale.
|
family of functions may or may not honor the current locale.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR locale (1),
|
.BR locale (1),
|
||||||
|
|
|
@ -53,7 +53,7 @@ On Linux, this call is just an interface for
|
||||||
(In general, the relation between
|
(In general, the relation between
|
||||||
.BR lockf ()
|
.BR lockf ()
|
||||||
and
|
and
|
||||||
.BR fcntl ()
|
.BR fcntl (2)
|
||||||
is unspecified.)
|
is unspecified.)
|
||||||
.LP
|
.LP
|
||||||
Valid operations are given below:
|
Valid operations are given below:
|
||||||
|
|
|
@ -36,20 +36,21 @@ longjmp, siglongjmp \- non-local jump to a saved stack context
|
||||||
.fi
|
.fi
|
||||||
.ad b
|
.ad b
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
\fBlongjmp\fP() and \fBsetjmp\fP() are useful for dealing with errors
|
\fBlongjmp\fP() and \fBsetjmp\fP(3) are useful for dealing with errors
|
||||||
and interrupts encountered in a low-level subroutine of a program.
|
and interrupts encountered in a low-level subroutine of a program.
|
||||||
\fBlongjmp\fP() restores the environment saved by the last call of
|
\fBlongjmp\fP() restores the environment saved by the last call of
|
||||||
\fBsetjmp\fP() with the corresponding \fIenv\fP argument.
|
\fBsetjmp\fP(3) with the corresponding \fIenv\fP argument.
|
||||||
After
|
After
|
||||||
\fBlongjmp\fP() is completed, program execution continues as if the
|
\fBlongjmp\fP() is completed, program execution continues as if the
|
||||||
corresponding call of \fBsetjmp\fP() had just returned the value
|
corresponding call of \fBsetjmp\fP(3) had just returned the value
|
||||||
\fIval\fP. \fBlongjmp\fP() cannot cause 0 to be returned.
|
\fIval\fP.
|
||||||
|
\fBlongjmp\fP() cannot cause 0 to be returned.
|
||||||
If \fBlongjmp\fP()
|
If \fBlongjmp\fP()
|
||||||
is invoked with a second argument of 0, 1 will be returned instead.
|
is invoked with a second argument of 0, 1 will be returned instead.
|
||||||
.P
|
.P
|
||||||
\fBsiglongjmp\fP() is similar to \fBlongjmp\fP() except for the type of
|
\fBsiglongjmp\fP() is similar to \fBlongjmp\fP() except for the type of
|
||||||
its \fIenv\fP argument.
|
its \fIenv\fP argument.
|
||||||
If the \fBsigsetjmp\fP() call that set this
|
If the \fBsigsetjmp\fP(3) call that set this
|
||||||
\fIenv\fP used a non-zero \fIsavesigs\fP flag, \fBsiglongjmp\fP() also
|
\fIenv\fP used a non-zero \fIsavesigs\fP flag, \fBsiglongjmp\fP() also
|
||||||
restores the set of blocked signals.
|
restores the set of blocked signals.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
|
|
|
@ -34,7 +34,7 @@ makecontext, swapcontext \- manipulate user context
|
||||||
In a System V-like environment, one has the type \fIucontext_t\fP defined in
|
In a System V-like environment, one has the type \fIucontext_t\fP defined in
|
||||||
.I <ucontext.h>
|
.I <ucontext.h>
|
||||||
and the four functions
|
and the four functions
|
||||||
\fBgetcontext\fP(), \fBsetcontext\fP(), \fBmakecontext\fP()
|
\fBgetcontext\fP(3), \fBsetcontext\fP(3), \fBmakecontext\fP()
|
||||||
and \fBswapcontext\fP() that allow user-level context switching
|
and \fBswapcontext\fP() that allow user-level context switching
|
||||||
between multiple threads of control within a process.
|
between multiple threads of control within a process.
|
||||||
.LP
|
.LP
|
||||||
|
@ -42,13 +42,13 @@ For the type and the first two functions, see
|
||||||
.BR getcontext (2).
|
.BR getcontext (2).
|
||||||
.LP
|
.LP
|
||||||
The \fBmakecontext\fP() function modifies the context pointed to
|
The \fBmakecontext\fP() function modifies the context pointed to
|
||||||
by \fIucp\fP (which was obtained from a call to \fBgetcontext\fP()).
|
by \fIucp\fP (which was obtained from a call to \fBgetcontext\fP(3)).
|
||||||
Before invoking \fBmakecontext\fP(), the caller must allocate a new stack
|
Before invoking \fBmakecontext\fP(), the caller must allocate a new stack
|
||||||
for this context and assign its address to \fIucp->uc_stack\fP,
|
for this context and assign its address to \fIucp->uc_stack\fP,
|
||||||
and define a successor context and
|
and define a successor context and
|
||||||
assign its address to \fIucp->uc_link\fP.
|
assign its address to \fIucp->uc_link\fP.
|
||||||
|
|
||||||
When this context is later activated (using \fBsetcontext\fP() or
|
When this context is later activated (using \fBsetcontext\fP(3) or
|
||||||
\fBswapcontext\fP()) the function \fIfunc\fP is called,
|
\fBswapcontext\fP()) the function \fIfunc\fP is called,
|
||||||
and passed the series of integer
|
and passed the series of integer
|
||||||
.RI ( int )
|
.RI ( int )
|
||||||
|
@ -86,7 +86,7 @@ SUSv2, POSIX.1-2001.
|
||||||
.SH EXAMPLE
|
.SH EXAMPLE
|
||||||
.PP
|
.PP
|
||||||
The example program below demonstrates the use of
|
The example program below demonstrates the use of
|
||||||
.BR getcontext (),
|
.BR getcontext (3),
|
||||||
.BR makecontext (),
|
.BR makecontext (),
|
||||||
and
|
and
|
||||||
.BR swapcontext ().
|
.BR swapcontext ().
|
||||||
|
|
|
@ -169,7 +169,7 @@ If
|
||||||
is set to 0, any detected heap corruption is silently ignored;
|
is set to 0, any detected heap corruption is silently ignored;
|
||||||
if set to 1, a diagnostic is printed on stderr;
|
if set to 1, a diagnostic is printed on stderr;
|
||||||
if set to 2,
|
if set to 2,
|
||||||
.BR abort ()
|
.BR abort (3)
|
||||||
is called immediately.
|
is called immediately.
|
||||||
This can be useful because otherwise
|
This can be useful because otherwise
|
||||||
a crash may happen much later, and the true cause for the problem
|
a crash may happen much later, and the true cause for the problem
|
||||||
|
|
|
@ -30,10 +30,10 @@ __after_morecore_hook \- malloc debugging variables
|
||||||
.BI "void (*__after_morecore_hook)(void);"
|
.BI "void (*__after_morecore_hook)(void);"
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The GNU C library lets you modify the behavior of
|
The GNU C library lets you modify the behavior of
|
||||||
.BR malloc (),
|
.BR malloc (3),
|
||||||
.BR realloc (),
|
.BR realloc (3),
|
||||||
and
|
and
|
||||||
.BR free ()
|
.BR free (3)
|
||||||
by specifying appropriate hook functions.
|
by specifying appropriate hook functions.
|
||||||
You can use these hooks
|
You can use these hooks
|
||||||
to help you debug programs that use dynamic memory allocation,
|
to help you debug programs that use dynamic memory allocation,
|
||||||
|
@ -60,20 +60,20 @@ The four functions pointed to by
|
||||||
.BR __memalign_hook ,
|
.BR __memalign_hook ,
|
||||||
.BR __free_hook
|
.BR __free_hook
|
||||||
have a prototype like the functions
|
have a prototype like the functions
|
||||||
.BR malloc (),
|
.BR malloc (3),
|
||||||
.BR realloc (),
|
.BR realloc (3),
|
||||||
.BR memalign (),
|
.BR memalign (3),
|
||||||
.BR free (),
|
.BR free (3),
|
||||||
respectively, except that they have a final argument
|
respectively, except that they have a final argument
|
||||||
.I caller
|
.I caller
|
||||||
that gives the address of the caller of
|
that gives the address of the caller of
|
||||||
.BR malloc (),
|
.BR malloc (3),
|
||||||
etc.
|
etc.
|
||||||
.LP
|
.LP
|
||||||
The variable
|
The variable
|
||||||
.B __after_morecore_hook
|
.B __after_morecore_hook
|
||||||
points at a function that is called each time after
|
points at a function that is called each time after
|
||||||
.BR sbrk ()
|
.BR sbrk (2)
|
||||||
was asked for more memory.
|
was asked for more memory.
|
||||||
.SH "EXAMPLE"
|
.SH "EXAMPLE"
|
||||||
Here is a short example of how to use these variables.
|
Here is a short example of how to use these variables.
|
||||||
|
|
|
@ -62,5 +62,5 @@ C99
|
||||||
The behaviour of \fBmblen\fP() depends on the LC_CTYPE category of the
|
The behaviour of \fBmblen\fP() depends on the LC_CTYPE category of the
|
||||||
current locale.
|
current locale.
|
||||||
.PP
|
.PP
|
||||||
The function \fBmbrlen\fP() provides a better interface to the same
|
The function \fBmbrlen\fP(3) provides a better interface to the same
|
||||||
functionality.
|
functionality.
|
||||||
|
|
|
@ -31,18 +31,19 @@ state is needed for the sake of encodings such as ISO-2022 and UTF-7.
|
||||||
.PP
|
.PP
|
||||||
The initial state is the state at the beginning of conversion of a string.
|
The initial state is the state at the beginning of conversion of a string.
|
||||||
There are two kinds of state: The one used by multibyte to wide character
|
There are two kinds of state: The one used by multibyte to wide character
|
||||||
conversion functions, such as \fBmbsrtowcs\fP(), and the one used by wide
|
conversion functions, such as \fBmbsrtowcs\fP(3), and the one used by wide
|
||||||
character to multibyte conversion functions, such as \fBwcsrtombs\fP(),
|
character to multibyte conversion functions, such as \fBwcsrtombs\fP(3),
|
||||||
but they both fit in a \fBmbstate_t\fP, and they both have the same
|
but they both fit in a \fBmbstate_t\fP, and they both have the same
|
||||||
representation for an initial state.
|
representation for an initial state.
|
||||||
.PP
|
.PP
|
||||||
For 8-bit encodings, all states are equivalent to the initial state.
|
For 8-bit encodings, all states are equivalent to the initial state.
|
||||||
For multibyte encodings like UTF-8, EUC-*, BIG5 or SJIS, the wide character
|
For multibyte encodings like UTF-8, EUC-*, BIG5 or SJIS, the wide character
|
||||||
to multibyte conversion functions never produce non-initial states, but the
|
to multibyte conversion functions never produce non-initial states, but the
|
||||||
multibyte to wide-character conversion functions like \fBmbrtowc\fP() do
|
multibyte to wide-character conversion functions like \fBmbrtowc\fP(3) do
|
||||||
produce non-initial states when interrupted in the middle of a character.
|
produce non-initial states when interrupted in the middle of a character.
|
||||||
.PP
|
.PP
|
||||||
One possible way to create an mbstate_t in initial state is to set it to zero:
|
One possible way to create an mbstate_t in initial
|
||||||
|
state is to set it to zero:
|
||||||
.nf
|
.nf
|
||||||
mbstate_t state;
|
mbstate_t state;
|
||||||
memset(&state,0,sizeof(mbstate_t));
|
memset(&state,0,sizeof(mbstate_t));
|
||||||
|
|
|
@ -24,7 +24,7 @@ mempcpy, wmempcpy \- copy memory area
|
||||||
The
|
The
|
||||||
.BR mempcpy ()
|
.BR mempcpy ()
|
||||||
function is nearly identical to the
|
function is nearly identical to the
|
||||||
.BR memcpy ()
|
.BR memcpy (3)
|
||||||
function.
|
function.
|
||||||
It copies
|
It copies
|
||||||
.I n
|
.I n
|
||||||
|
|
|
@ -61,7 +61,7 @@ The
|
||||||
.I mq_flags
|
.I mq_flags
|
||||||
field contains flags associated with the open message queue description.
|
field contains flags associated with the open message queue description.
|
||||||
This field is initialised when the queue is created by
|
This field is initialised when the queue is created by
|
||||||
.BR mq_open ().
|
.BR mq_open (3).
|
||||||
The only flag that can appear in this field is
|
The only flag that can appear in this field is
|
||||||
.BR O_NONBLOCK .
|
.BR O_NONBLOCK .
|
||||||
|
|
||||||
|
@ -70,12 +70,12 @@ The
|
||||||
and
|
and
|
||||||
.I mq_msgsize
|
.I mq_msgsize
|
||||||
fields are set when the message queue is created by
|
fields are set when the message queue is created by
|
||||||
.BR mq_open ().
|
.BR mq_open (3).
|
||||||
The
|
The
|
||||||
.I mq_maxmsg
|
.I mq_maxmsg
|
||||||
field is an upper limit on the number of messages
|
field is an upper limit on the number of messages
|
||||||
that may be placed on the queue using
|
that may be placed on the queue using
|
||||||
.BR mq_send ().
|
.BR mq_send (3).
|
||||||
The
|
The
|
||||||
.I mq_msgsize
|
.I mq_msgsize
|
||||||
field is an upper limit on the size of messages
|
field is an upper limit on the size of messages
|
||||||
|
|
|
@ -141,10 +141,10 @@ the queue is emptied and a new message arrives.
|
||||||
|
|
||||||
If another process or thread is waiting to read a message
|
If another process or thread is waiting to read a message
|
||||||
from an empty queue using
|
from an empty queue using
|
||||||
.BR mq_receive (),
|
.BR mq_receive (3),
|
||||||
then any message notification registration is ignored:
|
then any message notification registration is ignored:
|
||||||
the message is delivered to the process or thread calling
|
the message is delivered to the process or thread calling
|
||||||
.BR mq_receive (),
|
.BR mq_receive (3),
|
||||||
and the message notification registration remains in effect.
|
and the message notification registration remains in effect.
|
||||||
|
|
||||||
Notification occurs once: after a notification is delivered,
|
Notification occurs once: after a notification is delivered,
|
||||||
|
|
|
@ -64,9 +64,9 @@ in
|
||||||
.B O_NONBLOCK
|
.B O_NONBLOCK
|
||||||
Open the queue in non-blocking mode.
|
Open the queue in non-blocking mode.
|
||||||
In circumstances where
|
In circumstances where
|
||||||
.BR mq_receive ()
|
.BR mq_receive (3)
|
||||||
and
|
and
|
||||||
.BR mq_send ()
|
.BR mq_send (3)
|
||||||
would normally block, these functions instead fail with the error
|
would normally block, these functions instead fail with the error
|
||||||
.BR EAGAIN .
|
.BR EAGAIN .
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -15,10 +15,10 @@ mtrace, muntrace \- malloc debugging
|
||||||
The function
|
The function
|
||||||
.BR mtrace ()
|
.BR mtrace ()
|
||||||
installs handlers for
|
installs handlers for
|
||||||
.BR malloc (),
|
.BR malloc (3),
|
||||||
.BR realloc ()
|
.BR realloc (3)
|
||||||
and
|
and
|
||||||
.BR free ().
|
.BR free (3).
|
||||||
The function
|
The function
|
||||||
.BR muntrace ()
|
.BR muntrace ()
|
||||||
disables these handlers.
|
disables these handlers.
|
||||||
|
|
|
@ -32,9 +32,9 @@ and similarly calls to
|
||||||
and
|
and
|
||||||
.BR nanl ()
|
.BR nanl ()
|
||||||
are equivalent to analogous calls to
|
are equivalent to analogous calls to
|
||||||
.BR strtof ()
|
.BR strtof (3)
|
||||||
and
|
and
|
||||||
.BR strtold ().
|
.BR strtold (3).
|
||||||
.PP
|
.PP
|
||||||
The argument
|
The argument
|
||||||
.I tagp
|
.I tagp
|
||||||
|
|
|
@ -91,7 +91,7 @@ The
|
||||||
.BR forkpty ()
|
.BR forkpty ()
|
||||||
function combines
|
function combines
|
||||||
.BR openpty (),
|
.BR openpty (),
|
||||||
.BR fork (),
|
.BR fork (2),
|
||||||
and
|
and
|
||||||
.BR login_tty ()
|
.BR login_tty ()
|
||||||
to create a new process operating in a pseudo-terminal.
|
to create a new process operating in a pseudo-terminal.
|
||||||
|
@ -134,7 +134,7 @@ There are no available ttys.
|
||||||
.LP
|
.LP
|
||||||
.BR login_pty ()
|
.BR login_pty ()
|
||||||
will fail if
|
will fail if
|
||||||
.BR ioctl ()
|
.BR ioctl (2)
|
||||||
fails to set
|
fails to set
|
||||||
.I fd
|
.I fd
|
||||||
to the controlling terminal of the current process.
|
to the controlling terminal of the current process.
|
||||||
|
@ -143,7 +143,7 @@ to the controlling terminal of the current process.
|
||||||
will fail if either
|
will fail if either
|
||||||
.BR openpty ()
|
.BR openpty ()
|
||||||
or
|
or
|
||||||
.BR fork ()
|
.BR fork (2)
|
||||||
fails.
|
fails.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
These functions are included in libutil, hence you'll need to add
|
These functions are included in libutil, hence you'll need to add
|
||||||
|
|
|
@ -74,7 +74,7 @@ is a normal standard I/O stream in all respects save that it must be closed
|
||||||
with
|
with
|
||||||
.BR pclose ()
|
.BR pclose ()
|
||||||
rather than
|
rather than
|
||||||
.BR fclose ().
|
.BR fclose (3).
|
||||||
Writing to such a stream writes to the standard input of the command; the
|
Writing to such a stream writes to the standard input of the command; the
|
||||||
command's standard output is the same as that of the process that called
|
command's standard output is the same as that of the process that called
|
||||||
.BR popen (),
|
.BR popen (),
|
||||||
|
@ -92,7 +92,7 @@ The
|
||||||
.BR pclose ()
|
.BR pclose ()
|
||||||
function waits for the associated process to terminate and returns the exit
|
function waits for the associated process to terminate and returns the exit
|
||||||
status of the command as returned by
|
status of the command as returned by
|
||||||
.BR wait4 ().
|
.BR wait4 (2).
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The
|
The
|
||||||
.BR popen ()
|
.BR popen ()
|
||||||
|
@ -120,9 +120,9 @@ function does not set
|
||||||
.I errno
|
.I errno
|
||||||
if memory allocation fails.
|
if memory allocation fails.
|
||||||
If the underlying
|
If the underlying
|
||||||
.BR fork ()
|
.BR fork (2)
|
||||||
or
|
or
|
||||||
.BR pipe ()
|
.BR pipe (2)
|
||||||
fails,
|
fails,
|
||||||
.I errno
|
.I errno
|
||||||
is set appropriately.
|
is set appropriately.
|
||||||
|
|
|
@ -113,32 +113,32 @@ parameter is correct.
|
||||||
POSIX requires that memory obtained from
|
POSIX requires that memory obtained from
|
||||||
.BR posix_memalign ()
|
.BR posix_memalign ()
|
||||||
can be freed using
|
can be freed using
|
||||||
.BR free ().
|
.BR free (3).
|
||||||
Some systems provide no way to reclaim memory allocated with
|
Some systems provide no way to reclaim memory allocated with
|
||||||
.BR memalign ()
|
.BR memalign ()
|
||||||
or
|
or
|
||||||
.BR valloc ()
|
.BR valloc ()
|
||||||
(because one can only pass to
|
(because one can only pass to
|
||||||
.BR free ()
|
.BR free (3)
|
||||||
a pointer gotten from
|
a pointer gotten from
|
||||||
.BR malloc (),
|
.BR malloc (3),
|
||||||
while e.g.
|
while e.g.
|
||||||
.BR memalign ()
|
.BR memalign ()
|
||||||
would call
|
would call
|
||||||
.BR malloc ()
|
.BR malloc (3)
|
||||||
and then align the obtained value).
|
and then align the obtained value).
|
||||||
.\" Other systems allow passing the result of
|
.\" Other systems allow passing the result of
|
||||||
.\" .IR valloc ()
|
.\" .IR valloc ()
|
||||||
.\" to
|
.\" to
|
||||||
.\" .IR free (),
|
.\" .IR free (3),
|
||||||
.\" but not to
|
.\" but not to
|
||||||
.\" .IR realloc ().
|
.\" .IR realloc (3).
|
||||||
GNU libc allows memory obtained from any of these three routines to be
|
GNU libc allows memory obtained from any of these three routines to be
|
||||||
reclaimed with
|
reclaimed with
|
||||||
.BR free ().
|
.BR free (3).
|
||||||
|
|
||||||
GNU libc
|
GNU libc
|
||||||
.BR malloc ()
|
.BR malloc (3)
|
||||||
always returns 8-byte aligned memory addresses, so these routines are only
|
always returns 8-byte aligned memory addresses, so these routines are only
|
||||||
needed if you require larger alignment values.
|
needed if you require larger alignment values.
|
||||||
.SH AVAILABILITY
|
.SH AVAILABILITY
|
||||||
|
|
|
@ -672,7 +672,7 @@ modifier is present, the
|
||||||
.I wint_t
|
.I wint_t
|
||||||
(wide character) argument is converted to a multibyte sequence by a call
|
(wide character) argument is converted to a multibyte sequence by a call
|
||||||
to the
|
to the
|
||||||
.BR wcrtomb ()
|
.BR wcrtomb (3)
|
||||||
function, with a conversion state starting in the initial state, and the
|
function, with a conversion state starting in the initial state, and the
|
||||||
resulting multibyte string is written.
|
resulting multibyte string is written.
|
||||||
.TP
|
.TP
|
||||||
|
@ -698,7 +698,7 @@ modifier is present: The
|
||||||
argument is expected to be a pointer to an array of wide characters.
|
argument is expected to be a pointer to an array of wide characters.
|
||||||
Wide characters from the array are converted to multibyte characters
|
Wide characters from the array are converted to multibyte characters
|
||||||
(each by a call to the
|
(each by a call to the
|
||||||
.BR wcrtomb ()
|
.BR wcrtomb (3)
|
||||||
function, with a conversion state starting in the initial state before
|
function, with a conversion state starting in the initial state before
|
||||||
the first wide character), up to and including a terminating null
|
the first wide character), up to and including a terminating null
|
||||||
wide character.
|
wide character.
|
||||||
|
|
|
@ -14,7 +14,7 @@ putgrent \- write a group database entry to a file
|
||||||
The
|
The
|
||||||
.BR putgrent ()
|
.BR putgrent ()
|
||||||
function is the counterpart for
|
function is the counterpart for
|
||||||
.BR fgetgrent ().
|
.BR fgetgrent (3).
|
||||||
The function writes the content of the provided struct group into the
|
The function writes the content of the provided struct group into the
|
||||||
file pointed to by
|
file pointed to by
|
||||||
.IR fp .
|
.IR fp .
|
||||||
|
|
|
@ -23,7 +23,7 @@ putwchar \- write a wide character to standard output
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBputwchar\fP() function is the wide-character equivalent of the
|
The \fBputwchar\fP() function is the wide-character equivalent of the
|
||||||
\fBputchar\fP() function.
|
\fBputchar\fP(3) function.
|
||||||
It writes the wide character \fIwc\fP to \fBstdout\fP.
|
It writes the wide character \fIwc\fP to \fBstdout\fP.
|
||||||
If \fIferror(stdout)\fP becomes true, it returns WEOF.
|
If \fIferror(stdout)\fP becomes true, it returns WEOF.
|
||||||
If a wide character
|
If a wide character
|
||||||
|
|
|
@ -43,10 +43,10 @@ The functions
|
||||||
and
|
and
|
||||||
.BR qgcvt ()
|
.BR qgcvt ()
|
||||||
are identical to
|
are identical to
|
||||||
.BR ecvt ,
|
.BR ecvt (3),
|
||||||
.BR fcvt
|
.BR fcvt (3)
|
||||||
and
|
and
|
||||||
.BR gcvt
|
.BR gcvt (3)
|
||||||
respectively, except that they use a
|
respectively, except that they use a
|
||||||
.I "long double"
|
.I "long double"
|
||||||
argument
|
argument
|
||||||
|
@ -58,7 +58,7 @@ and
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
These functions are obsolete.
|
These functions are obsolete.
|
||||||
Instead,
|
Instead,
|
||||||
.BR sprintf ()
|
.BR sprintf (3)
|
||||||
is recommended.
|
is recommended.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
SVr4.
|
SVr4.
|
||||||
|
|
|
@ -64,11 +64,11 @@ SVr4, 4.3BSD, C89, C99.
|
||||||
Library routines suitable for use as the
|
Library routines suitable for use as the
|
||||||
.I compar
|
.I compar
|
||||||
argument include
|
argument include
|
||||||
.BR alphasort ()
|
.BR alphasort (3)
|
||||||
and
|
and
|
||||||
.BR versionsort ().
|
.BR versionsort (3).
|
||||||
To compare C strings, the comparison function can call
|
To compare C strings, the comparison function can call
|
||||||
.BR strcmp (),
|
.BR strcmp (3),
|
||||||
as shown in the example below.
|
as shown in the example below.
|
||||||
.SH EXAMPLE
|
.SH EXAMPLE
|
||||||
For one example of use, see the example under
|
For one example of use, see the example under
|
||||||
|
|
|
@ -123,16 +123,16 @@ impossible to determine a suitable size for the output buffer,
|
||||||
According to POSIX a buffer of size PATH_MAX suffices, but
|
According to POSIX a buffer of size PATH_MAX suffices, but
|
||||||
PATH_MAX need not be a defined constant, and may have to be
|
PATH_MAX need not be a defined constant, and may have to be
|
||||||
obtained using
|
obtained using
|
||||||
.BR pathconf ().
|
.BR pathconf (3).
|
||||||
And asking
|
And asking
|
||||||
.BR pathconf ()
|
.BR pathconf (3)
|
||||||
does not really help, since on the one hand POSIX warns that
|
does not really help, since on the one hand POSIX warns that
|
||||||
the result of
|
the result of
|
||||||
.BR pathconf ()
|
.BR pathconf (3)
|
||||||
may be huge and unsuitable for mallocing memory.
|
may be huge and unsuitable for mallocing memory.
|
||||||
And on the other
|
And on the other
|
||||||
hand
|
hand
|
||||||
.BR pathconf ()
|
.BR pathconf (3)
|
||||||
may return \-1 to signify that PATH_MAX is not bounded.
|
may return \-1 to signify that PATH_MAX is not bounded.
|
||||||
.LP
|
.LP
|
||||||
The libc4 and libc5 implementation contains a buffer overflow
|
The libc4 and libc5 implementation contains a buffer overflow
|
||||||
|
@ -150,7 +150,7 @@ In 4.4BSD and Solaris the limit on the pathname length is MAXPATHLEN
|
||||||
(found in <sys/param.h>).
|
(found in <sys/param.h>).
|
||||||
SUSv2 prescribes PATH_MAX and
|
SUSv2 prescribes PATH_MAX and
|
||||||
NAME_MAX, as found in <limits.h> or provided by the
|
NAME_MAX, as found in <limits.h> or provided by the
|
||||||
.BR pathconf ()
|
.BR pathconf (3)
|
||||||
function.
|
function.
|
||||||
A typical source fragment would be
|
A typical source fragment would be
|
||||||
.LP
|
.LP
|
||||||
|
|
|
@ -39,9 +39,9 @@ remove \- delete a name and possibly the file it refers to
|
||||||
.BR remove ()
|
.BR remove ()
|
||||||
deletes a name from the filesystem.
|
deletes a name from the filesystem.
|
||||||
It calls
|
It calls
|
||||||
.BR unlink ()
|
.BR unlink (2)
|
||||||
for files, and
|
for files, and
|
||||||
.BR rmdir ()
|
.BR rmdir (2)
|
||||||
for directories.
|
for directories.
|
||||||
|
|
||||||
If the removed name was the
|
If the removed name was the
|
||||||
|
@ -76,7 +76,7 @@ disappearance of files which are still being used.
|
||||||
Under libc4 and libc5,
|
Under libc4 and libc5,
|
||||||
.BR remove ()
|
.BR remove ()
|
||||||
was an alias for
|
was an alias for
|
||||||
.BR unlink ()
|
.BR unlink (2)
|
||||||
(and hence would not remove directories).
|
(and hence would not remove directories).
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR rm (1),
|
.BR rm (1),
|
||||||
|
|
|
@ -39,7 +39,7 @@ Compile with \-std=c99; link with \-lm.
|
||||||
These functions round \fIx\fP to the nearest integer, but
|
These functions round \fIx\fP to the nearest integer, but
|
||||||
round halfway cases away from zero (regardless of the current rounding
|
round halfway cases away from zero (regardless of the current rounding
|
||||||
direction), instead of to the nearest even integer like
|
direction), instead of to the nearest even integer like
|
||||||
.BR rint ().
|
.BR rint (3).
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The rounded integer value.
|
The rounded integer value.
|
||||||
If \fIx\fP is integral or infinite,
|
If \fIx\fP is integral or infinite,
|
||||||
|
|
|
@ -44,7 +44,7 @@ user-supplied response, perhaps obtained with \fBfgets\fP(3) or
|
||||||
|
|
||||||
The user's language preference is taken into account per the
|
The user's language preference is taken into account per the
|
||||||
environment variables \fBLANG\fP, \fBLC_MESSAGES\fP, and \fBLC_ALL\fP,
|
environment variables \fBLANG\fP, \fBLC_MESSAGES\fP, and \fBLC_ALL\fP,
|
||||||
if the program has called \fBsetlocale\fP() to effect their changes.
|
if the program has called \fBsetlocale\fP(3) to effect their changes.
|
||||||
|
|
||||||
Regardless of the locale, responses matching \fB^[Yy]\fP are always
|
Regardless of the locale, responses matching \fB^[Yy]\fP are always
|
||||||
accepted as affirmative, and those matching \fB^[Nn]\fP are always
|
accepted as affirmative, and those matching \fB^[Nn]\fP are always
|
||||||
|
|
10
man3/rtime.3
10
man3/rtime.3
|
@ -35,11 +35,11 @@ In case of error \-1 is returned, and
|
||||||
is set appropriately.
|
is set appropriately.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
All errors for underlying functions
|
All errors for underlying functions
|
||||||
.RB ( sendto (),
|
.RB ( sendto (2),
|
||||||
.BR poll (),
|
.BR poll (2),
|
||||||
.BR recvfrom (),
|
.BR recvfrom (2),
|
||||||
.BR connect (),
|
.BR connect (2),
|
||||||
.BR read ())
|
.BR read (2))
|
||||||
can occur.
|
can occur.
|
||||||
Moreover:
|
Moreover:
|
||||||
.TP
|
.TP
|
||||||
|
|
|
@ -55,7 +55,7 @@ by FLT_RADIX (probably 2) to the power
|
||||||
If FLT_RADIX equals 2, then
|
If FLT_RADIX equals 2, then
|
||||||
.BR scalbn ()
|
.BR scalbn ()
|
||||||
is equivalent to
|
is equivalent to
|
||||||
.BR ldexp ().
|
.BR ldexp (3).
|
||||||
|
|
||||||
The value of FLT_RADIX is found in
|
The value of FLT_RADIX is found in
|
||||||
.IR <float.h> .
|
.IR <float.h> .
|
||||||
|
|
|
@ -53,9 +53,9 @@ The \fBscandir\fP() function scans the directory \fIdir\fP, calling
|
||||||
\fIfilter\fP() on each directory entry.
|
\fIfilter\fP() on each directory entry.
|
||||||
Entries for which
|
Entries for which
|
||||||
\fIfilter\fP() returns non-zero are stored in strings allocated via
|
\fIfilter\fP() returns non-zero are stored in strings allocated via
|
||||||
\fBmalloc\fP(), sorted using \fBqsort\fP() with the comparison
|
\fBmalloc\fP(3), sorted using \fBqsort\fP(3) with the comparison
|
||||||
function \fIcompar\fP(), and collected in array \fInamelist\fP
|
function \fIcompar\fP(), and collected in array \fInamelist\fP
|
||||||
which is allocated via \fBmalloc\fP().
|
which is allocated via \fBmalloc\fP(3).
|
||||||
If \fIfilter\fP is NULL, all entries are selected.
|
If \fIfilter\fP is NULL, all entries are selected.
|
||||||
.LP
|
.LP
|
||||||
The
|
The
|
||||||
|
|
|
@ -117,9 +117,9 @@ The
|
||||||
function scans a variable argument list from the standard input and the
|
function scans a variable argument list from the standard input and the
|
||||||
.BR vsscanf ()
|
.BR vsscanf ()
|
||||||
function scans it from a string; these are analogous to the
|
function scans it from a string; these are analogous to the
|
||||||
.BR vprintf ()
|
.BR vprintf (3)
|
||||||
and
|
and
|
||||||
.BR vsprintf ()
|
.BR vsprintf (3)
|
||||||
functions respectively.
|
functions respectively.
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
|
|
|
@ -37,8 +37,8 @@ stream.
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBseekdir\fP() function sets the location in the directory stream
|
The \fBseekdir\fP() function sets the location in the directory stream
|
||||||
from which the next \fBreaddir\fP() call will start. \fBseekdir\fP()
|
from which the next \fBreaddir\fP(2) call will start.
|
||||||
should be used with an offset returned by \fBtelldir\fP().
|
\fBseekdir\fP() should be used with an offset returned by \fBtelldir\fP(3).
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The \fBseekdir\fP() function returns no value.
|
The \fBseekdir\fP() function returns no value.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -148,7 +148,7 @@ set an alarm timer to generate a
|
||||||
.B SIGALRM
|
.B SIGALRM
|
||||||
signal.
|
signal.
|
||||||
This handler performs a
|
This handler performs a
|
||||||
.BR sem_post ()
|
.BR sem_post (3)
|
||||||
to increment the semaphore that is being waited on in
|
to increment the semaphore that is being waited on in
|
||||||
.I main()
|
.I main()
|
||||||
using
|
using
|
||||||
|
|
|
@ -36,20 +36,20 @@ setjmp, sigsetjmp \- save stack context for non-local goto
|
||||||
.fi
|
.fi
|
||||||
.ad b
|
.ad b
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
\fBsetjmp\fP() and \fBlongjmp\fP() are useful for dealing with errors
|
\fBsetjmp\fP() and \fBlongjmp\fP(3) are useful for dealing with errors
|
||||||
and interrupts encountered in a low-level subroutine of a program.
|
and interrupts encountered in a low-level subroutine of a program.
|
||||||
\fBsetjmp\fP() saves the stack context/environment in \fIenv\fP for
|
\fBsetjmp\fP() saves the stack context/environment in \fIenv\fP for
|
||||||
later use by \fBlongjmp\fP().
|
later use by \fBlongjmp\fP(3).
|
||||||
The stack context will be invalidated
|
The stack context will be invalidated
|
||||||
if the function which called \fBsetjmp\fP() returns.
|
if the function which called \fBsetjmp\fP() returns.
|
||||||
.P
|
.P
|
||||||
\fBsigsetjmp\fP() is similar to \fBsetjmp\fP().
|
\fBsigsetjmp\fP() is similar to \fBsetjmp\fP().
|
||||||
If \fIsavesigs\fP is non-zero,
|
If \fIsavesigs\fP is non-zero,
|
||||||
the set of blocked signals is saved in \fIenv\fP and will be restored
|
the set of blocked signals is saved in \fIenv\fP and will be restored
|
||||||
if a \fBsiglongjmp\fP() is later performed with this \fIenv\fP.
|
if a \fBsiglongjmp\fP(3) is later performed with this \fIenv\fP.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
\fBsetjmp\fP() and \fBsigsetjmp\fP() return 0 if returning directly, and
|
\fBsetjmp\fP() and \fBsigsetjmp\fP() return 0 if returning directly, and
|
||||||
non-zero when returning from \fBlongjmp\fP() using the saved context.
|
non-zero when returning from \fBlongjmp\fP(3) using the saved context.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
C89, C99, and POSIX.1-2001 specify \fBsetjmp\fP().
|
C89, C99, and POSIX.1-2001 specify \fBsetjmp\fP().
|
||||||
POSIX.1-2001 specifies \fBsigsetjmp\fP().
|
POSIX.1-2001 specifies \fBsigsetjmp\fP().
|
||||||
|
|
|
@ -141,17 +141,17 @@ A program may be made portable to all locales by calling
|
||||||
.B setlocale(LC_ALL, """""")
|
.B setlocale(LC_ALL, """""")
|
||||||
after program initialization, by using the values returned
|
after program initialization, by using the values returned
|
||||||
from a
|
from a
|
||||||
.BR localeconv ()
|
.BR localeconv (3)
|
||||||
call
|
call
|
||||||
for locale-dependent information, by using the multi-byte and wide
|
for locale-dependent information, by using the multi-byte and wide
|
||||||
character functions for text processing if
|
character functions for text processing if
|
||||||
.BR "MB_CUR_MAX > 1" ,
|
.BR "MB_CUR_MAX > 1" ,
|
||||||
and by using
|
and by using
|
||||||
.BR strcoll () ,
|
.BR strcoll (3) ,
|
||||||
.BR wcscoll ()
|
.BR wcscoll (3)
|
||||||
or
|
or
|
||||||
.BR strxfrm (),
|
.BR strxfrm (3),
|
||||||
.BR wcsxfrm ()
|
.BR wcsxfrm (3)
|
||||||
to compare strings.
|
to compare strings.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
A successful call to
|
A successful call to
|
||||||
|
@ -175,7 +175,7 @@ locale (e.g. in libc-4.5.21 and libc-4.6.27), and the Russian
|
||||||
(more precisely, "koi-8r") locale (e.g. in libc-4.6.27),
|
(more precisely, "koi-8r") locale (e.g. in libc-4.6.27),
|
||||||
so that having an environment variable LC_CTYPE=ISO-8859-1
|
so that having an environment variable LC_CTYPE=ISO-8859-1
|
||||||
sufficed to make
|
sufficed to make
|
||||||
.BR isprint ()
|
.BR isprint (3)
|
||||||
return the right answer.
|
return the right answer.
|
||||||
These days non-English speaking Europeans have to work a bit harder,
|
These days non-English speaking Europeans have to work a bit harder,
|
||||||
and must install actual locale files.
|
and must install actual locale files.
|
||||||
|
|
|
@ -171,7 +171,7 @@ prototype more easily readable.
|
||||||
The
|
The
|
||||||
.BR sigset ()
|
.BR sigset ()
|
||||||
function provides reliable signal handling semantics (as when calling
|
function provides reliable signal handling semantics (as when calling
|
||||||
.BR sigaction ()
|
.BR sigaction (2)
|
||||||
with
|
with
|
||||||
.I sa_mask
|
.I sa_mask
|
||||||
equal to 0).
|
equal to 0).
|
||||||
|
@ -179,7 +179,7 @@ equal to 0).
|
||||||
On System V, the
|
On System V, the
|
||||||
.BR signal ()
|
.BR signal ()
|
||||||
function provides unreliable semantics (as when calling
|
function provides unreliable semantics (as when calling
|
||||||
.BR sigaction ()
|
.BR sigaction (2)
|
||||||
with
|
with
|
||||||
.I sa_mask
|
.I sa_mask
|
||||||
equal to
|
equal to
|
||||||
|
|
|
@ -138,7 +138,7 @@ Handle the signal on the alternate signal stack
|
||||||
(historically established under BSD using the obsolete
|
(historically established under BSD using the obsolete
|
||||||
.BR sigstack ()
|
.BR sigstack ()
|
||||||
function; the POSIX replacement is
|
function; the POSIX replacement is
|
||||||
.BR sigaltstack ()).
|
.BR sigaltstack (2)).
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.BR sigmask ()
|
.BR sigmask ()
|
||||||
|
|
|
@ -44,13 +44,13 @@ POSIX.1-2001.
|
||||||
may be implemented using
|
may be implemented using
|
||||||
.BR SIGALRM ;
|
.BR SIGALRM ;
|
||||||
mixing calls to
|
mixing calls to
|
||||||
.BR alarm ()
|
.BR alarm (3)
|
||||||
and
|
and
|
||||||
.BR sleep ()
|
.BR sleep ()
|
||||||
is a bad idea.
|
is a bad idea.
|
||||||
.PP
|
.PP
|
||||||
Using
|
Using
|
||||||
.BR longjmp ()
|
.BR longjmp (3)
|
||||||
from a signal handler or modifying the handling of
|
from a signal handler or modifying the handling of
|
||||||
.B SIGALRM
|
.B SIGALRM
|
||||||
while sleeping will cause undefined results.
|
while sleeping will cause undefined results.
|
||||||
|
|
|
@ -66,7 +66,7 @@ can safely be called from a handler for the SIGURG signal.
|
||||||
.BR sockatmark ()
|
.BR sockatmark ()
|
||||||
is implemented using the
|
is implemented using the
|
||||||
.B SIOCATMARK
|
.B SIOCATMARK
|
||||||
.BR ioctl ()
|
.BR ioctl (2)
|
||||||
operation.
|
operation.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
POSIX.1-2001
|
POSIX.1-2001
|
||||||
|
|
|
@ -52,7 +52,7 @@ as appropriate for the current locale.
|
||||||
SVr4, 4.3BSD, C89, C99.
|
SVr4, 4.3BSD, C89, C99.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
In the \fI"POSIX"\fP or \fI"C"\fP locales \fBstrcoll\fP() is equivalent to
|
In the \fI"POSIX"\fP or \fI"C"\fP locales \fBstrcoll\fP() is equivalent to
|
||||||
\fBstrcmp\fP().
|
\fBstrcmp\fP(3).
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR bcmp (3),
|
.BR bcmp (3),
|
||||||
.BR memcmp (3),
|
.BR memcmp (3),
|
||||||
|
|
|
@ -57,7 +57,7 @@ The \fBstrerror\fP() function returns a string describing the error
|
||||||
code passed in the argument \fIerrnum\fP, possibly using the LC_MESSAGES
|
code passed in the argument \fIerrnum\fP, possibly using the LC_MESSAGES
|
||||||
part of the current locale to select the appropriate language.
|
part of the current locale to select the appropriate language.
|
||||||
This string must not be modified by the application, but may be
|
This string must not be modified by the application, but may be
|
||||||
modified by a subsequent call to \fBperror\fP() or \fBstrerror\fP().
|
modified by a subsequent call to \fBperror\fP(3) or \fBstrerror\fP().
|
||||||
No library function will modify this string.
|
No library function will modify this string.
|
||||||
|
|
||||||
The \fBstrerror_r\fP() function is similar to \fBstrerror\fP(), but is
|
The \fBstrerror_r\fP() function is similar to \fBstrerror\fP(), but is
|
||||||
|
|
|
@ -40,7 +40,7 @@ strptime \- convert a string representation of time to a time tm structure
|
||||||
The
|
The
|
||||||
.BR strptime ()
|
.BR strptime ()
|
||||||
function is the converse function to
|
function is the converse function to
|
||||||
.BR strftime ()
|
.BR strftime (3)
|
||||||
and converts the character string pointed to by
|
and converts the character string pointed to by
|
||||||
.I s
|
.I s
|
||||||
to values which are stored in the
|
to values which are stored in the
|
||||||
|
@ -271,7 +271,7 @@ returns NULL.
|
||||||
SUSv2, POSIX.1-2001.
|
SUSv2, POSIX.1-2001.
|
||||||
.SH EXAMPLE
|
.SH EXAMPLE
|
||||||
The following example demonstrates the use of \fBstrptime\fP()
|
The following example demonstrates the use of \fBstrptime\fP()
|
||||||
and \fBstrftime\fP().
|
and \fBstrftime\fP(3).
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
|
@ -293,7 +293,7 @@ main(void)
|
||||||
For reasons of symmetry, glibc tries to support for
|
For reasons of symmetry, glibc tries to support for
|
||||||
.BR strptime ()
|
.BR strptime ()
|
||||||
the same format characters as for
|
the same format characters as for
|
||||||
.BR strftime ().
|
.BR strftime (3).
|
||||||
(In most cases the corresponding fields are parsed, but no field in \fItm\fP
|
(In most cases the corresponding fields are parsed, but no field in \fItm\fP
|
||||||
is changed.)
|
is changed.)
|
||||||
This leads to
|
This leads to
|
||||||
|
@ -324,7 +324,7 @@ An RFC-822/ISO 8601 standard time zone specification.
|
||||||
.B %Z
|
.B %Z
|
||||||
The timezone name.
|
The timezone name.
|
||||||
.LP
|
.LP
|
||||||
Similarly, because of GNU extensions to \fIstrftime\fP(),
|
Similarly, because of GNU extensions to \fIstrftime\fP(3),
|
||||||
%k is accepted as a synonym for %H, and %l should be accepted
|
%k is accepted as a synonym for %H, and %l should be accepted
|
||||||
as a synonym for %I, and %P is accepted as a synonym for %p.
|
as a synonym for %I, and %P is accepted as a synonym for %p.
|
||||||
Finally
|
Finally
|
||||||
|
|
|
@ -53,10 +53,10 @@ The \fBstrsep\fP() function returns a pointer to the token,
|
||||||
that is, it returns the original value of *\fIstringp\fP.
|
that is, it returns the original value of *\fIstringp\fP.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
The \fBstrsep\fP() function was introduced as a replacement for
|
The \fBstrsep\fP() function was introduced as a replacement for
|
||||||
\fBstrtok\fP(), since the latter cannot handle empty fields.
|
\fBstrtok\fP(3), since the latter cannot handle empty fields.
|
||||||
However, \fBstrtok\fP() conforms to C89/C99 and hence is more portable.
|
However, \fBstrtok\fP(3) conforms to C89/C99 and hence is more portable.
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
This function suffers from the same problems as \fBstrtok\fP().
|
This function suffers from the same problems as \fBstrtok\fP(3).
|
||||||
In particular, it modifies the original string.
|
In particular, it modifies the original string.
|
||||||
Avoid it.
|
Avoid it.
|
||||||
.SH "CONFORMING TO"
|
.SH "CONFORMING TO"
|
||||||
|
|
|
@ -33,9 +33,9 @@ strtoimax, strtoumax \- convert string to integer
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
These functions are just like
|
These functions are just like
|
||||||
.BR strtol ()
|
.BR strtol (3)
|
||||||
and
|
and
|
||||||
.BR strtoul (),
|
.BR strtoul (3),
|
||||||
except that they return a value of type
|
except that they return a value of type
|
||||||
.B intmax_t
|
.B intmax_t
|
||||||
and
|
and
|
||||||
|
|
|
@ -51,7 +51,7 @@ which again uses
|
||||||
Thus, the task of
|
Thus, the task of
|
||||||
.BR strverscmp ()
|
.BR strverscmp ()
|
||||||
is to compare two strings and find the "right" order, while
|
is to compare two strings and find the "right" order, while
|
||||||
.BR strcmp ()
|
.BR strcmp (3)
|
||||||
only finds the lexicographic order.
|
only finds the lexicographic order.
|
||||||
This function does not use
|
This function does not use
|
||||||
the locale category LC_COLLATE, so is meant mostly for situations
|
the locale category LC_COLLATE, so is meant mostly for situations
|
||||||
|
@ -66,7 +66,7 @@ Find the largest consecutive digit strings containing (or starting at,
|
||||||
or ending at) this position.
|
or ending at) this position.
|
||||||
If one or both of these is empty,
|
If one or both of these is empty,
|
||||||
then return what
|
then return what
|
||||||
.BR strcmp ()
|
.BR strcmp (3)
|
||||||
would have returned (numerical ordering of byte values).
|
would have returned (numerical ordering of byte values).
|
||||||
Otherwise, compare both digit strings numerically, where digit strings with
|
Otherwise, compare both digit strings numerically, where digit strings with
|
||||||
one or more leading zeroes are interpreted as if they have a decimal point
|
one or more leading zeroes are interpreted as if they have a decimal point
|
||||||
|
|
|
@ -36,9 +36,9 @@ strxfrm \- string transformation
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The \fBstrxfrm\fP() function transforms the \fIsrc\fP string into a
|
The \fBstrxfrm\fP() function transforms the \fIsrc\fP string into a
|
||||||
form such that the result of \fBstrcmp\fP() on two strings that have
|
form such that the result of \fBstrcmp\fP(3) on two strings that have
|
||||||
been transformed with \fBstrxfrm\fP() is the same as the result of
|
been transformed with \fBstrxfrm\fP() is the same as the result of
|
||||||
\fBstrcoll\fP() on the two strings before their transformation.
|
\fBstrcoll\fP(3) on the two strings before their transformation.
|
||||||
The first \fIn\fP characters of the transformed string are placed in
|
The first \fIn\fP characters of the transformed string are placed in
|
||||||
\fIdest\fP.
|
\fIdest\fP.
|
||||||
The transformation is based on the program's current
|
The transformation is based on the program's current
|
||||||
|
@ -53,7 +53,7 @@ contents of \fIdest\fP are indeterminate.
|
||||||
SVr4, 4.3BSD, C89, C99
|
SVr4, 4.3BSD, C89, C99
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
In the \fI"POSIX"\fP or \fI"C"\fP locales \fBstrxfrm\fP() is equivalent to
|
In the \fI"POSIX"\fP or \fI"C"\fP locales \fBstrxfrm\fP() is equivalent to
|
||||||
copying the string with \fBstrncpy\fP().
|
copying the string with \fBstrncpy\fP(3).
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR bcmp (3),
|
.BR bcmp (3),
|
||||||
.BR memcmp (3),
|
.BR memcmp (3),
|
||||||
|
|
|
@ -51,7 +51,7 @@ and
|
||||||
will be ignored.
|
will be ignored.
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The value returned is \-1 on error (e.g.
|
The value returned is \-1 on error (e.g.
|
||||||
.BR fork ()
|
.BR fork (2)
|
||||||
failed),
|
failed),
|
||||||
and the return status of the command otherwise.
|
and the return status of the command otherwise.
|
||||||
This latter return status is in the format
|
This latter return status is in the format
|
||||||
|
@ -139,7 +139,7 @@ the calling program has previously called
|
||||||
.PP
|
.PP
|
||||||
It is possible for the shell command to return 127, so that code is not
|
It is possible for the shell command to return 127, so that code is not
|
||||||
a sure indication that the
|
a sure indication that the
|
||||||
.BR execve ()
|
.BR execve (2)
|
||||||
call failed.
|
call failed.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR sh (1),
|
.BR sh (1),
|
||||||
|
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue