Mark lists as in the rest of section 9 manpages.

Submitted by:	Joel Dahl (mostly)
This commit is contained in:
Ruslan Ermilov 2005-01-28 10:43:05 +00:00
parent 7146d6cb3e
commit 0a57ea7df2
28 changed files with 180 additions and 148 deletions

View File

@ -47,13 +47,13 @@ given credentials.
Its arguments are: Its arguments are:
.Bl -tag -width mode .Bl -tag -width mode
.It Fa vp .It Fa vp
the vnode of the file to check The vnode of the file to check.
.It Fa mode .It Fa mode
the type of access required The type of access required.
.It Fa cred .It Fa cred
the user credentials to check The user credentials to check.
.It Fa td .It Fa td
the thread which is checking The thread which is checking.
.El .El
.Pp .Pp
The The

View File

@ -44,15 +44,15 @@ control list (ACL) for a particular file or directory.
Its arguments are: Its arguments are:
.Bl -tag -width type .Bl -tag -width type
.It Fa vp .It Fa vp
the vnode of the file or directory The vnode of the file or directory.
.It Fa type .It Fa type
the type of ACL to check The type of ACL to check.
.It Fa aclp .It Fa aclp
a pointer to an ACL structure from which to retrieve the ACL data A pointer to an ACL structure from which to retrieve the ACL data.
.It Fa cred .It Fa cred
the user credentials to use in authorizing the request The user credentials to use in authorizing the request.
.It Fa td .It Fa td
the thread checking the ACL The thread checking the ACL.
.El .El
.Pp .Pp
The The

View File

@ -45,25 +45,32 @@
The arguments are: The arguments are:
.Bl -tag -width flags .Bl -tag -width flags
.It Fa vp .It Fa vp
the vnode being manipulated The vnode being manipulated.
.It Fa id .It Fa id
the id token which is changing the lock The id token which is changing the lock.
.It Fa op .It Fa op
the operation to perform (see The operation to perform (see
.Xr fcntl 2 ) .Xr fcntl 2 ) .
.It Fa fl .It Fa fl
description of the lock Description of the lock.
.It Fa flags .It Fa flags
One of more of the following: One of more of the following:
.Bl -column F_UNLCK -offset indent .Pp
.It Dv F_RDLCK Ta "shared or read lock" .Bl -tag -width ".Dv F_UNLCK" -offset indent -compact
.It Dv F_UNLCK Ta "unlock" .It Dv F_RDLCK
.It Dv F_WRLCK Ta "exclusive or write lock" Shared or read lock.
.It Dv F_WAIT Ta "Wait until lock is granted" .It Dv F_UNLCK
.It Dv F_FLOCK Ta Use Unlock.
.It Dv F_WRLCK
Exclusive or write lock.
.It Dv F_WAIT
Wait until lock is granted.
.It Dv F_FLOCK
Use
.Xr flock 2 .Xr flock 2
semantics for lock semantics for lock.
.It Dv F_POSIX Ta "Use POSIX semantics for lock" .It Dv F_POSIX
Use POSIX semantics for lock.
.El .El
.El .El
.Pp .Pp

View File

@ -50,13 +50,13 @@ access time and modification time.
The arguments are: The arguments are:
.Bl -tag -width cred .Bl -tag -width cred
.It Fa vp .It Fa vp
the vnode of the file The vnode of the file.
.It Fa vap .It Fa vap
the attributes of the file The attributes of the file.
.It Fa cred .It Fa cred
the user credentials of the calling process The user credentials of the calling process.
.It Fa td .It Fa td
the thread The thread.
.El .El
.Pp .Pp
Attributes which are not being modified by Attributes which are not being modified by

View File

@ -43,9 +43,9 @@
The arguments are: The arguments are:
.Bl -tag -width 2n .Bl -tag -width 2n
.It Fa vp .It Fa vp
the vnode of the file being written to The vnode of the file being written to.
.It Fa bp .It Fa bp
the buffer to be written The buffer to be written.
.El .El
.Sh RETURN VALUES .Sh RETURN VALUES
Zero is returned on success, otherwise an error is returned. Zero is returned on success, otherwise an error is returned.

View File

@ -56,15 +56,15 @@ in a given directory.
The arguments are: The arguments are:
.Bl -tag -width target .Bl -tag -width target
.It Fa dvp .It Fa dvp
the locked vnode of the directory The locked vnode of the directory.
.It Fa vpp .It Fa vpp
the address of a variable where the resulting locked vnode should be stored The address of a variable where the resulting locked vnode should be stored.
.It Fa cnp .It Fa cnp
the pathname component created The pathname component created.
.It Fa vap .It Fa vap
the attributes that the new object should be created with The attributes that the new object should be created with.
.It Fa target .It Fa target
the pathname of the target of the symlink The pathname of the target of the symlink.
.El .El
.Pp .Pp
These entry points are called after These entry points are called after

View File

@ -50,22 +50,22 @@ system calls.
Its arguments are: Its arguments are:
.Bl -tag -width waitfor .Bl -tag -width waitfor
.It Fa vp .It Fa vp
the vnode of the file The vnode of the file.
.It Fa cred .It Fa cred
the caller's credentials The caller's credentials.
.It Fa waitfor .It Fa waitfor
whether the function should wait for I/O to complete. Whether the function should wait for I/O to complete.
Possible values are: Possible values are:
.Bl -tag -width MNT_NOWAIT .Bl -tag -width MNT_NOWAIT
.It Dv MNT_WAIT .It Dv MNT_WAIT
synchronously wait for I/O to complete Synchronously wait for I/O to complete.
.It Dv MNT_NOWAIT .It Dv MNT_NOWAIT
start all I/O, but do not wait for it Start all I/O, but do not wait for it.
.It Dv MNT_LAZY .It Dv MNT_LAZY
push data not written by file system syncer Push data not written by file system syncer.
.El .El
.It Fa td .It Fa td
the calling thread The calling thread.
.El .El
.Pp .Pp
The argument The argument

View File

@ -44,15 +44,15 @@ file or directory.
Its arguments are: Its arguments are:
.Bl -tag -width type .Bl -tag -width type
.It Fa vp .It Fa vp
the vnode of the file or directory The vnode of the file or directory.
.It Fa type .It Fa type
the type of ACL to retrieve The type of ACL to retrieve.
.It Fa aclp .It Fa aclp
a pointer to an ACL structure to receive the ACL data A pointer to an ACL structure to receive the ACL data.
.It Fa cred .It Fa cred
the user credentials to use in authorizing the request The user credentials to use in authorizing the request.
.It Fa td .It Fa td
the thread requesting the ACL The thread requesting the ACL.
.El .El
.Pp .Pp
The The

View File

@ -52,16 +52,16 @@ from a file or directory.
Its arguments are: Its arguments are:
.Bl -tag -width ".Fa attrnamespace" .Bl -tag -width ".Fa attrnamespace"
.It Fa vp .It Fa vp
the vnode of the file or directory The vnode of the file or directory.
.It Fa attrnamespace .It Fa attrnamespace
integer constant indicating which extended attribute namespace the attribute Integer constant indicating which extended attribute namespace the attribute
name is present in name is present in.
.It Fa name .It Fa name
pointer to a null-terminated character string containing the attribute name Pointer to a null-terminated character string containing the attribute name.
.It Fa uio .It Fa uio
the location of the data to be read The location of the data to be read.
.It Fa size .It Fa size
if not If not
.Dv NULL , .Dv NULL ,
on return it will contain the number of bytes required to read all of the on return it will contain the number of bytes required to read all of the
attribute data. attribute data.
@ -73,9 +73,9 @@ when
.Fa size .Fa size
is not, and vise versa. is not, and vise versa.
.It Fa cred .It Fa cred
the user credentials to use in authorizing the request The user credentials to use in authorizing the request.
.It Fa td .It Fa td
the thread requesting the extended attribute The thread requesting the extended attribute.
.El .El
.Pp .Pp
The The

View File

@ -48,9 +48,9 @@ with a particular vnode.
The arguments specific to these functions are: The arguments specific to these functions are:
.Bl -tag -width objpp .Bl -tag -width objpp
.It Fa vp .It Fa vp
the vnode of the file The vnode of the file.
.It Fa objpp .It Fa objpp
the VM object being returned, or The VM object being returned, or
.Dv NULL .Dv NULL
if the caller wants to test for the existence if the caller wants to test for the existence
of the VM object). of the VM object).

View File

@ -46,7 +46,7 @@
The arguments are: The arguments are:
.Bl -tag -width 2n .Bl -tag -width 2n
.It Fa vp .It Fa vp
the vnode being reclaimed The vnode being reclaimed.
.El .El
.Pp .Pp
.Fn VOP_INACTIVE .Fn VOP_INACTIVE

View File

@ -45,17 +45,17 @@ Manipulate a file in device dependent ways.
Its arguments are: Its arguments are:
.Bl -tag -width command .Bl -tag -width command
.It Fa vp .It Fa vp
the vnode of the file (normally representing a device) The vnode of the file (normally representing a device).
.It Fa command .It Fa command
the device specific operation to perform The device specific operation to perform.
.It Fa cnp .It Fa cnp
extra data for the specified operation Extra data for the specified operation.
.It Fa fflag .It Fa fflag
some flags ??? Some flags ???
.It Fa cred .It Fa cred
the caller's credentials The caller's credentials.
.It Fa td .It Fa td
the calling thread The calling thread.
.El .El
.Pp .Pp
Most file systems do not implement this entry point. Most file systems do not implement this entry point.

View File

@ -45,11 +45,11 @@ This links a new name in the specified directory to an existing file.
Its arguments are: Its arguments are:
.Bl -tag -width 8n .Bl -tag -width 8n
.It Fa dvp .It Fa dvp
the vnode of the directory The vnode of the directory.
.It Fa vp .It Fa vp
the vnode of the file to be linked The vnode of the file to be linked.
.It Fa cnp .It Fa cnp
pathname information about the file Pathname information about the file.
.El .El
.Pp .Pp
The pathname info should The pathname info should

View File

@ -56,14 +56,14 @@ from a specified namespace on a file or directory.
Its arguments are: Its arguments are:
.Bl -tag -width ".Fa attrnamespace" .Bl -tag -width ".Fa attrnamespace"
.It Fa vp .It Fa vp
the vnode of the file or directory The vnode of the file or directory.
.It Fa attrnamespace .It Fa attrnamespace
integer constant indicating which extended attribute namespace the attribute Integer constant indicating which extended attribute namespace the attribute
name is present in name is present in.
.It Fa uio .It Fa uio
the location of the data to be read The location of the data to be read.
.It Fa size .It Fa size
if not If not
.Dv NULL , .Dv NULL ,
on return it will contain the number of bytes required to read the list. on return it will contain the number of bytes required to read the list.
The resulting data will be an The resulting data will be an
@ -78,9 +78,9 @@ when
.Fa size .Fa size
is not, and vise versa. is not, and vise versa.
.It Fa cred .It Fa cred
the user credentials to use in authorizing the request The user credentials to use in authorizing the request.
.It Fa td .It Fa td
the thread requesting the extended attribute The thread requesting the extended attribute.
.El .El
.Pp .Pp
The The

View File

@ -57,41 +57,60 @@ same time.
The arguments are: The arguments are:
.Bl -tag -width flags .Bl -tag -width flags
.It Fa vp .It Fa vp
the vnode being locked or unlocked The vnode being locked or unlocked.
.It Fa flags .It Fa flags
One of the lock request types: One of the lock request types:
.Bl -column LK_EXCLUPGRADE -offset indent .Pp
.It Dv LK_SHARED Ta "Shared lock" .Bl -tag -width ".Dv LK_EXCLUPGRADE" -offset indent -compact
.It Dv LK_EXCLUSIVE Ta "Exclusive lock" .It Dv LK_SHARED
.It Dv LK_UPGRADE Ta "Shared-to-exclusive upgrade" Shared lock.
.It Dv LK_EXCLUPGRADE Ta "First shared-to-exclusive upgrade" .It Dv LK_EXCLUSIVE
.It Dv LK_DOWNGRADE Ta "Exclusive-to-shared downgrade" Exclusive lock.
.It Dv LK_RELEASE Ta "Release any type of lock" .It Dv LK_UPGRADE
.It Dv LK_DRAIN Ta "Wait for all lock activity to end" Shared-to-exclusive upgrade.
.It Dv LK_EXCLUPGRADE
First shared-to-exclusive upgrade.
.It Dv LK_DOWNGRADE
Exclusive-to-shared downgrade.
.It Dv LK_RELEASE
Release any type of lock.
.It Dv LK_DRAIN
Wait for all lock activity to end.
.El .El
.Pp .Pp
The lock type may be The lock type may be
.Em or Ns 'ed .Em or Ns 'ed
with these lock flags: with these lock flags:
.Bl -column LK_CANRECURSE -offset indent .Pp
.It Dv LK_NOWAIT Ta "Do not sleep to wait for lock" .Bl -tag -width ".Dv LK_EXCLUPGRADE" -offset indent -compact
.It Dv LK_SLEEPFAIL Ta "Sleep, then return failure" .It Dv LK_NOWAIT
.It Dv LK_CANRECURSE Ta "Allow recursive exclusive lock" Do not sleep to wait for lock.
.It Dv LK_REENABLE Ta "Lock is to be reenabled after drain" .It Dv LK_SLEEPFAIL
.It Dv LK_NOPAUSE Ta "No spinloop" Sleep, then return failure.
.It Dv LK_CANRECURSE
Allow recursive exclusive lock.
.It Dv LK_REENABLE
Lock is to be reenabled after drain.
.It Dv LK_NOPAUSE
No spinloop.
.El .El
.Pp .Pp
The lock type may be The lock type may be
.Em or Ns 'ed .Em or Ns 'ed
with these control flags: with these control flags:
.Bl -column LK_INTERLOCK -offset indent .Pp
.It Dv LK_INTERLOCK Ta "Specify when the caller already has a simple lock \ .Bl -tag -width ".Dv LK_EXCLUPGRADE" -offset indent -compact
(VOP_LOCK will unlock the simple lock after getting the lock)" .It Dv LK_INTERLOCK
.It Dv LK_RETRY Ta "Retry until locked" Specify when the caller already has a simple lock
.It Dv LK_NOOBJ Ta "Don't create object" .Fn ( VOP_LOCK
will unlock the simple lock after getting the lock).
.It Dv LK_RETRY
Retry until locked.
.It Dv LK_NOOBJ
Don't create object.
.El .El
.It Fa td .It Fa td
thread context to use for the locks Thread context to use for the locks.
.El .El
.Pp .Pp
Kernel code should use Kernel code should use

View File

@ -46,11 +46,11 @@ This entry point looks up a single pathname component in a given directory.
Its arguments are: Its arguments are:
.Bl -tag -width vpp .Bl -tag -width vpp
.It Fa dvp .It Fa dvp
the locked vnode of the directory to search The locked vnode of the directory to search.
.It Fa vpp .It Fa vpp
the address of a variable where the resulting locked vnode should be stored The address of a variable where the resulting locked vnode should be stored.
.It Fa cnp .It Fa cnp
the pathname component to be searched for The pathname component to be searched for.
.El .El
.Pp .Pp
.Fa Cnp .Fa Cnp

View File

@ -52,11 +52,11 @@ entry point is called after a file is finished with by the process.
The arguments are: The arguments are:
.Bl -tag -width mode .Bl -tag -width mode
.It Fa vp .It Fa vp
the vnode of the file The vnode of the file.
.It Fa mode .It Fa mode
the access mode required by the calling process The access mode required by the calling process.
.It Fa td .It Fa td
the thread which is accessing the file The thread which is accessing the file.
.El .El
.Pp .Pp
Additionally, Additionally,

View File

@ -44,11 +44,11 @@
The arguments are: The arguments are:
.Bl -tag -width retval .Bl -tag -width retval
.It Fa vp .It Fa vp
the vnode to get information about The vnode to get information about.
.It Fa name .It Fa name
the type of information to return The type of information to return.
.It Fa retval .It Fa retval
the place to return the information The place to return the information.
.El .El
.Pp .Pp
The value of The value of

View File

@ -43,7 +43,7 @@
The arguments are: The arguments are:
.Bl -tag -width 2n .Bl -tag -width 2n
.It Fa vp .It Fa vp
the vnode to print The vnode to print.
.El .El
.Sh RETURN VALUES .Sh RETURN VALUES
Zero is returned on success, otherwise an error is returned. Zero is returned on success, otherwise an error is returned.

View File

@ -49,13 +49,13 @@ These entry points read or write the contents of a file
The arguments are: The arguments are:
.Bl -tag -width ioflag .Bl -tag -width ioflag
.It Fa vp .It Fa vp
the vnode of the file The vnode of the file.
.It Fa uio .It Fa uio
the location of the data to be read or written The location of the data to be read or written.
.It Fa ioflag .It Fa ioflag
various flags Various flags.
.It Fa cnp .It Fa cnp
the credentials of the caller The credentials of the caller.
.El .El
.Pp .Pp
The The
@ -66,20 +66,20 @@ read-ahead hint (in units of file system blocks) that the file system
should attempt. should attempt.
The low 16 bits are a bit mask which can contain The low 16 bits are a bit mask which can contain
the following flags: the following flags:
.Bl -tag -width IO_NODELOCKED .Bl -tag -width ".Dv IO_NODELOCKED"
.It Dv IO_UNIT .It Dv IO_UNIT
do I/O as atomic unit Do I/O as atomic unit.
.It Dv IO_APPEND .It Dv IO_APPEND
append write to end Append write to end.
.It Dv IO_SYNC .It Dv IO_SYNC
do I/O synchronously Do I/O synchronously.
.It Dv IO_NODELOCKED .It Dv IO_NODELOCKED
underlying node already locked Underlying node already locked.
.It Dv IO_NDELAY .It Dv IO_NDELAY
.Dv FNDELAY .Dv FNDELAY
flag set in file table flag set in file table.
.It Dv IO_VMIO .It Dv IO_VMIO
data already in VMIO space Data already in VMIO space.
.El .El
.Sh LOCKS .Sh LOCKS
The file should be locked on entry and will still be locked on exit. The file should be locked on entry and will still be locked on exit.

View File

@ -44,17 +44,23 @@
Read directory entries. Read directory entries.
.Bl -tag -width ncookies .Bl -tag -width ncookies
.It Fa vp .It Fa vp
the vnode of the directory The vnode of the directory.
.It Fa uio .It Fa uio
where to read the directory contents Where to read the directory contents.
.It Fa cred .It Fa cred
the caller's credentials The caller's credentials.
.It Fa eofflag .It Fa eofflag
return end of file status (NULL if not wanted) Return end of file status
.Dv ( NULL
if not wanted).
.It Fa ncookies .It Fa ncookies
number of directory cookies generated for NFS (NULL if not wanted) Number of directory cookies generated for NFS
.Dv ( NULL
if not wanted).
.It Fa cookies .It Fa cookies
directory seek cookies generated for NFS (NULL if not wanted) Directory seek cookies generated for NFS
.Dv ( NULL
if not wanted).
.El .El
The directory contents are read into The directory contents are read into
.Vt struct dirent .Vt struct dirent

View File

@ -44,11 +44,11 @@
This reads the target pathname of a symbolic link This reads the target pathname of a symbolic link
.Bl -tag -width uio .Bl -tag -width uio
.It Fa vp .It Fa vp
the vnode of the symlink The vnode of the symlink.
.It Fa uio .It Fa uio
the location of the data to be read or written The location of the data to be read or written.
.It Fa cred .It Fa cred
the credentials of the caller The credentials of the caller.
.El .El
.Sh LOCKS .Sh LOCKS
The vnode should be locked on entry and will still be locked on exit. The vnode should be locked on entry and will still be locked on exit.

View File

@ -43,9 +43,9 @@
The arguments are: The arguments are:
.Bl -tag -width buflist .Bl -tag -width buflist
.It Fa vp .It Fa vp
the file to manipulate The file to manipulate.
.It Fa buflist .It Fa buflist
a list of buffers to rearrange A list of buffers to rearrange.
.El .El
.Pp .Pp
This seems to be part of a work in progress. This seems to be part of a work in progress.

View File

@ -48,11 +48,11 @@ These entry points remove files and directories respectively.
The arguments are: The arguments are:
.Bl -tag -width dvp .Bl -tag -width dvp
.It Fa dvp .It Fa dvp
the vnode of the directory The vnode of the directory.
.It Fa vp .It Fa vp
the vnode of the file to be removed The vnode of the file to be removed.
.It Fa cnp .It Fa cnp
pathname information about the file Pathname information about the file.
.El .El
.Sh LOCKS .Sh LOCKS
Both Both

View File

@ -46,17 +46,17 @@ If the destination object exists, it will be removed first.
Its arguments are: Its arguments are:
.Bl -tag -width fdvp .Bl -tag -width fdvp
.It Fa fdvp .It Fa fdvp
the vnode of the old parent directory The vnode of the old parent directory.
.It Fa fvp .It Fa fvp
the vnode of the file to be renamed The vnode of the file to be renamed.
.It Fa fcnp .It Fa fcnp
pathname information about the file's current name Pathname information about the file's current name.
.It Fa tdvp .It Fa tdvp
the vnode of the new parent directory The vnode of the new parent directory.
.It Fa tvp .It Fa tvp
the vnode of the target file (if it exists) The vnode of the target file (if it exists).
.It Fa tcnp .It Fa tcnp
pathname information about the file's new name Pathname information about the file's new name.
.El .El
.Sh LOCKS .Sh LOCKS
The source directory and file are unlocked but are expected to have their The source directory and file are unlocked but are expected to have their

View File

@ -44,15 +44,15 @@ or directory.
Its arguments are: Its arguments are:
.Bl -tag -width type .Bl -tag -width type
.It Fa vp .It Fa vp
the vnode of the file or directory The vnode of the file or directory.
.It Fa type .It Fa type
the type of ACL to set The type of ACL to set.
.It Fa aclp .It Fa aclp
a pointer to an ACL structure from which to retrieve the ACL data A pointer to an ACL structure from which to retrieve the ACL data.
.It Fa cred .It Fa cred
the user credentials to use in authorizing the request The user credentials to use in authorizing the request.
.It Fa td .It Fa td
the thread setting the ACL The thread setting the ACL.
.El .El
.Pp .Pp
The The

View File

@ -44,18 +44,18 @@ file or directory.
Its arguments are: Its arguments are:
.Bl -tag -width type .Bl -tag -width type
.It Fa vp .It Fa vp
the vnode of the file or directory The vnode of the file or directory.
.It Fa attrnamespace .It Fa attrnamespace
integer constant indicating which extended attribute namespace the attribute Integer constant indicating which extended attribute namespace the attribute
name is present in name is present in.
.It Fa name .It Fa name
pointer to a null-terminated character string containing the attribute name Pointer to a null-terminated character string containing the attribute name.
.It Fa uio .It Fa uio
the location of the data to be read or written The location of the data to be read or written.
.It Fa cred .It Fa cred
the user credentials to use in authorizing the request The user credentials to use in authorizing the request.
.It Fa td .It Fa td
the thread setting the extended attribute The thread setting the extended attribute.
.El .El
.Pp .Pp
The uio structure is used in a manner similar to the argument of the same The uio structure is used in a manner similar to the argument of the same

View File

@ -43,9 +43,9 @@
The arguments are: The arguments are:
.Bl -tag -width 2n .Bl -tag -width 2n
.It Fa vp .It Fa vp
the vnode that the buffer is for The vnode that the buffer is for.
.It Fa bp .It Fa bp
the buffer to be read or written The buffer to be read or written.
.El .El
.Pp .Pp
This call either reads or writes data from a file, depending on the value of This call either reads or writes data from a file, depending on the value of