diff options
Diffstat (limited to 'usr/src/man/man9f')
| -rw-r--r-- | usr/src/man/man9f/Makefile | 2 | ||||
| -rw-r--r-- | usr/src/man/man9f/kmem_alloc.9f | 7 | ||||
| -rw-r--r-- | usr/src/man/man9f/pollhead_clean.9f | 64 |
3 files changed, 71 insertions, 2 deletions
diff --git a/usr/src/man/man9f/Makefile b/usr/src/man/man9f/Makefile index 1198accfda..4666def860 100644 --- a/usr/src/man/man9f/Makefile +++ b/usr/src/man/man9f/Makefile @@ -13,6 +13,7 @@ # Copyright 2011, Richard Lowe # Copyright 2013 Nexenta Systems, Inc. All rights reserved. # Copyright 2014 Garrett D'Amore <garrett@damore> +# Copyright (c) 2015 Joyent, Inc. All rights reserved. # include $(SRC)/Makefile.master @@ -392,6 +393,7 @@ MANFILES= ASSERT.9f \ pm_power_has_changed.9f \ pm_raise_power.9f \ pm_trans_check.9f \ + pollhead_clean.9f \ pollwakeup.9f \ priv_getbyname.9f \ priv_policy.9f \ diff --git a/usr/src/man/man9f/kmem_alloc.9f b/usr/src/man/man9f/kmem_alloc.9f index 9c4f8ccb0c..201544b57c 100644 --- a/usr/src/man/man9f/kmem_alloc.9f +++ b/usr/src/man/man9f/kmem_alloc.9f @@ -129,5 +129,8 @@ uninitialized kernel memory should be handled carefully. For example, never .SH NOTES .sp .LP -\fBkmem_alloc(0\fR, \fIflag\fR\fB)\fR always returns \fINULL\fR. -\fBkmem_free(NULL, 0)\fR is legal. +\fBkmem_alloc(0\fR, \fIflag\fR\fB)\fR always returns \fINULL\fR, but +if \fBKM_SLEEP\fR is set, this behavior is considered to be deprecated; +the system may be configured to explicitly panic in this case in lieu +of returning \fINULL\fR. +\fBkmem_free(NULL, 0)\fR is legal, however. diff --git a/usr/src/man/man9f/pollhead_clean.9f b/usr/src/man/man9f/pollhead_clean.9f new file mode 100644 index 0000000000..a163a65a51 --- /dev/null +++ b/usr/src/man/man9f/pollhead_clean.9f @@ -0,0 +1,64 @@ +'\" te +.\" Copyright (c) 2015, Joyent, Inc. All Rights Reserved. +.\" This file and its contents are supplied under the terms of the +.\" Common Development and Distribution License ("CDDL"), version 1.0. +.\" You may only use this file in accordance with the terms of version +.\" 1.0 of the CDDL. +.\" +.\" A full copy of the text of the CDDL should have accompanied this +.\" source. A copy of the CDDL is also available via the Internet at +.\" http://www.illumos.org/license/CDDL. +.TH POLLHEAD_CLEAN 9F "Jun 12, 1998" +.\" +.\" A little inside joke with the above date: that's the date that the +.\" devpoll work integrated (under bug 1265897). The original work included +.\" pollhead_clean() -- but didn't bother to document it! With the date, +.\" we are therefore giving this man page the date it should have had in an +.\" attempt to right an historical wrong -- albeit nearly two decades after +.\" the fact. +.\" +.SH NAME +pollhead_clean \- inform the kernel that a pollhead is being deallocated +.SH SYNOPSIS +.LP +.nf +#include <sys/poll.h> + + + +\fBvoid\fR \fBpollhead_clean\fR(\fBstruct pollhead *\fR\fIphp\fR); +.fi + +.SH INTERFACE LEVEL +.sp +.LP +Architecture independent level 1 (DDI/DKI). +.SH PARAMETERS +.sp +.ne 2 +.na +\fB\fIphp\fR\fR +.ad +.RS 9n +Pointer to a \fBpollhead\fR structure. +.RE + +.SH DESCRIPTION +.sp +.LP +The \fBpollhead_clean()\fR function informs the kernel that a driver's +\fBpollhead\fR structure is about to be deallocated, usually as part of +the driver's \fBclose\fR(9E) entry point before the software state that +contains the \fBpollhead\fR is deallocated via \fBddi_soft_state_free\fR(9F). +See \fBchpoll\fR(9E), \fBpollwakeup\fR(9E) and \fBpoll\fR(2) for more detail. +.SH CONTEXT +.sp +.LP +The \fBpollhead_clean()\fR function is generally called from the context +of a \fBclose\fR(9E) entry point, but may be called from user or kernel +context. +.SH SEE ALSO +.sp +.LP +\fBpoll\fR(2), \fBchpoll\fR(9E), \fBpollwakeup\fR(9E) + |