returns the serial number of the key it created or updated.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EACCES
.BR syscall (2)),
all operations return \-1 and set
.I errno
-to indicate the cause of the error.
+to indicate the error.
.PP
The return value on success depends on the operation,
as described in the following list:
returns the calling thread's nice value, which may be a negative number.
On error, it returns \-1 and sets
.I errno
-to indicate the cause of the error.
+to indicate the error.
.PP
Since a successful call to
.BR getpriority ()
returns zero.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EBADF
operation returns 0 on success.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
Possible errors include:
.TP
.B EFAULT
operation returns 0 on success.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
Possible errors include:
.\" FIXME Is the following error list correct?
.\"
operation returns 0 on success.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
Possible errors include:
.TP
.B EINVAL
In this case, the entire area was copied.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
Possible errors include:
.TP
.B EAGAIN
In this case, the entire area was zeroed.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
Possible errors include:
.TP
.B EAGAIN
operation returns 0 on success.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
Possible errors include:
.TP
.B EINVAL
.IR "(void\ *)\ \-1" )
is returned, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.PP
On success,
.BR munmap ()
returns 0.
On failure, it returns \-1, and
.I errno
-is set to indicate the cause of the error (probably to
+is set to indicate the error (probably to
.BR EINVAL ).
.SH ERRORS
.TP
.PP
In the event of an error, both system calls return \-1 and set
.I errno
-to indicate the cause of the error.
+to indicate the error.
.SH ERRORS
.BR name_to_handle_at ()
and
returns zero when the operation is successful.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH VERSIONS
.BR perfmonctl ()
is available since Linux 2.4.
returns a file descriptor (a nonnegative integer).
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EBADF
returns a file descriptor (a nonnegative integer).
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EINVAL
returns 0.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EBADF
.PP
On error, \-1 is returned, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EFAULT
.PP
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.BR pread ()
can fail and set
.BR readahead ()
returns 0; on failure, \-1 is returned, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B EBADF
returns the serial number of the key it found or caused to be created.
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EACCES
return 0.
On error, \-1 is returned, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.BR sched_getattr ()
and
.BR gettid (2).)
On other errors, \-1 is returned, and
.IR errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.BR seccomp ()
can fail for the following reasons:
.I (void\ *)\ \-1
is returned, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.PP
On success,
.BR shmdt ()
returns 0; on error \-1 is returned, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
When
.BR shmat ()
returns zero.
On error, \-1 is returned, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EFAULT
.SH RETURN VALUE
On success, the number of bytes written is returned.
On error, \-1 is returned, and \fIerrno\fP is set
-to indicate the cause of the error.
+to indicate the error.
.PP
Note that a successful
.BR write ()
.BR bindresvport ()
returns 0 on success; otherwise \-1 is returned and
.I errno
-set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.BR bindresvport ()
can fail for any of the same reasons as
The remaining functions return NULL on error.
On error,
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EOVERFLOW
returns a file descriptor (a nonnegative integer).
On error, \-1 is returned, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
POSIX.1-2008 specifies two errors,
neither of which is returned by the current
.IR "(locale_t)\ 0",
and sets
.I errno
-to indicate the cause of the error.
+to indicate the error.
.SH ERRORS
.TP
.B ENOMEM
.IP * 3
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error
+is set to indicate the error
(for example,
.BR EINVAL ,
indicating that
these functions return a nonnegative value as given in DESCRIPTION.
On failure, they return \-1 and set
.I errno
-to indicate the cause of the error.
+to indicate the error.
.SH ERRORS
.TP
.B ENOSYS
returns a pointer to the username when successful,
and NULL on failure, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.BR getlogin_r ()
returns 0 when successful, and nonzero on failure.
.SH ERRORS
The functions which have \fIint\fP as the return value return 0 for
success and \-1 for failure, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.PP
For the nonreentrant functions, the return value may point to static area,
and may be overwritten by subsequent calls to these functions.
return nonzero on success.
They return 0 on error, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.PP
On success,
.BR hsearch ()
returns nonzero on success, and 0 on error.
In the event of an error, these two functions set
.I errno
-to indicate the cause of the error.
+to indicate the error.
.SH ERRORS
.BR hcreate_r ()
and
returns the number of bits in the network number.
On error, it returns \-1, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.PP
On success,
.BR inet_net_ntop ()
.IR pres .
On error, it returns NULL, and
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
.SH ERRORS
.TP
.B EAFNOSUPPORT
.IR "(locale_t)\ 0",
and sets
.I errno
-to indicate the cause of the error.
+to indicate the error.
.SH ERRORS
.TP
.B EINVAL
.BR pvalloc ()
return a pointer to the allocated memory on success.
On error, NULL is returned, and \fIerrno\fP is set
-to indicate the cause of the error.
+to indicate the error.
.PP
.BR posix_memalign ()
returns zero on success, or one of the error values listed in the
.IR pthread_mutex_consistent ()
returns 0.
Otherwise,
-it returns a positive error number to indicate the cause of the error.
+it returns a positive error number to indicate the error.
.SH ERRORS
.TP
.B EINVAL
returns a pointer to the previous state array.
On error, it returns NULL, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B EINVAL
All of these functions return 0 on success.
On error, \-1 is returned, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B EINVAL
selected.
On error, \-1 is returned, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.PP
The
.BR alphasort ()
functions return zero on success,
or \-1 on error, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B EINVAL
.SH ERRORS
On failure,
.I errno
-is set to indicate the cause of the error.
+is set to indicate the error.
Values which may appear in
.I errno
include the following:
.I sig
is invalid, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B EINVAL
.PP
On error, these functions set
.I errno
-to indicate the cause of the error.
+to indicate the error.
.SH ERRORS
.TP
.B EINVAL
string.
It returns NULL if insufficient memory was available, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B ENOMEM
.IP * 3
On error, \-1 is returned and
.I errno
-is set to indicate the cause of the error
+is set to indicate the error
(for example,
.BR EINVAL ,
indicating that
function returns a pointer to a unique temporary filename.
It returns NULL if a unique name cannot be generated, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B ENOMEM
.I (time_t)\ \-1
and set
.I errno
-to indicate the cause of the error.
+to indicate the error.
.SH ERRORS
.TP
.B EOVERFLOW
.IR "(locale_t)\ 0" ,
and sets
.I errno
-to indicate the cause of the error.
+to indicate the error.
.SH ERRORS
.TP
.B EINVAL
function returns 0 on success.
On error, \-1 is returned, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B EINTR
returns a pointer to the new wide-character string.
On error, it returns NULL, with
.I errno
-set to indicate the cause of the error.
+set to indicate the error.
.SH ERRORS
.TP
.B ENOMEM