diff options
author | ru <ru@FreeBSD.org> | 2002-11-29 11:39:20 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2002-11-29 11:39:20 +0000 |
commit | 6d3a461a4f20776be1a83de2eada39cb152efd48 (patch) | |
tree | e178090675cafc86fcb97bb414bb098780299953 /share/man/man9 | |
parent | da32bc58a0c07d9ab5fab6a3dc0c10e746ac2dbd (diff) | |
download | FreeBSD-src-6d3a461a4f20776be1a83de2eada39cb152efd48.zip FreeBSD-src-6d3a461a4f20776be1a83de2eada39cb152efd48.tar.gz |
mdoc(7) police: scheduled sweep.
Approved by: re
Diffstat (limited to 'share/man/man9')
-rw-r--r-- | share/man/man9/VOP_IOCTL.9 | 4 | ||||
-rw-r--r-- | share/man/man9/VOP_LINK.9 | 14 | ||||
-rw-r--r-- | share/man/man9/VOP_RENAME.9 | 6 | ||||
-rw-r--r-- | share/man/man9/ifnet.9 | 2 | ||||
-rw-r--r-- | share/man/man9/random.9 | 19 | ||||
-rw-r--r-- | share/man/man9/style.9 | 11 | ||||
-rw-r--r-- | share/man/man9/swi.9 | 2 | ||||
-rw-r--r-- | share/man/man9/zone.9 | 23 |
8 files changed, 49 insertions, 32 deletions
diff --git a/share/man/man9/VOP_IOCTL.9 b/share/man/man9/VOP_IOCTL.9 index 5265d74..3670d62 100644 --- a/share/man/man9/VOP_IOCTL.9 +++ b/share/man/man9/VOP_IOCTL.9 @@ -64,7 +64,9 @@ The file should not be locked on entry. .Sh RETURN VALUES If successful, zero is returned, otherwise an appropriate error code. .Pp -If the ioctl is not recognized or not handled, ENOTTY should be returned. +If the ioctl is not recognized or not handled, +.Er ENOTTY +should be returned. .Sh PSEUDOCODE .Bd -literal int diff --git a/share/man/man9/VOP_LINK.9 b/share/man/man9/VOP_LINK.9 index 7c355dd..f95c55d 100644 --- a/share/man/man9/VOP_LINK.9 +++ b/share/man/man9/VOP_LINK.9 @@ -52,13 +52,17 @@ the vnode of the file to be linked pathname information about the file .El .Pp -The pathname info should NOT be released on exit because it is done +The pathname info should +.Em not +be released on exit because it is done by the caller. -The directory and file vnodes should NOT be released on exit. +The directory and file vnodes should +.Em not +be released on exit. .Sh LOCKS .Xr VOP_LINK 9 expects the directory and file vnodes to be locked on entry and will leave -the vnodes locked on return. +the vnodes locked on return. .Sh RETURN VALUES Zero is returned if the file was linked successfully, otherwise an error is returned. @@ -97,12 +101,8 @@ vop_link(struct vnode *dvp, struct vnode *vp, struct componentname *cnp) .Bl -tag -width Er .It Bq Er EMLINK The file has too many links. -.El -.Bl -tag -width Er .It Bq Er EPERM The file is immutable. -.El -.Bl -tag -width Er .It Bq Er EXDEV A hard link is not possible between different file systems. .El diff --git a/share/man/man9/VOP_RENAME.9 b/share/man/man9/VOP_RENAME.9 index 2424e13..a3c3546 100644 --- a/share/man/man9/VOP_RENAME.9 +++ b/share/man/man9/VOP_RENAME.9 @@ -298,10 +298,10 @@ The file is immutable. It is not possible to rename a file between different file systems. .It Bq Er EINVAL An attempt was made to rename -.Ql .\& +.Pa \&. or -.Ql \&.. , -or a perform an operation which would break the directory tree structure. +.Pa .. , +or to perform an operation which would break the directory tree structure. .It Bq Er ENOTDIR An attempt was made to rename a directory to a file or vice versa. .It Bq Er ENOTEMPTY diff --git a/share/man/man9/ifnet.9 b/share/man/man9/ifnet.9 index 216ff36..b640ccf 100644 --- a/share/man/man9/ifnet.9 +++ b/share/man/man9/ifnet.9 @@ -444,7 +444,7 @@ This interface is in promiscuous mode. .It Dv IFF_PPROMISC .Aq D This interface is in the permanently promiscuous mode (implies -IFF_PROMISC). +.Dv IFF_PROMISC ) . .It Dv IFF_ALLMULTI .Aq D* This interface is in all-multicasts mode (used by multicast routers). diff --git a/share/man/man9/random.9 b/share/man/man9/random.9 index 98d0ffa..e8f365f 100644 --- a/share/man/man9/random.9 +++ b/share/man/man9/random.9 @@ -30,6 +30,7 @@ .Os .Dt RANDOM 9 .Sh NAME +.Nm arc4rand , .Nm arc4random , .Nm random , .Nm read_random , @@ -58,11 +59,11 @@ by calling with .Ql 1 as the -.Ar seed . +.Fa seed . The .Fn srandom function may be called with any arbitrary -.Ar seed +.Fa seed value to get slightly more unpredictable numbers. It is important to remember that the .Fn random @@ -79,7 +80,7 @@ are seeded from the entropy device if it is available. Automatic reseeds happen after a certain timeinterval and after a certain number of bytes have been delivered. A forced reseed can be forced by passing a non-zero value in the -.Ar reseed +.Fa reseed argument. .Pp The @@ -87,17 +88,17 @@ The function is used to return entropy directly from the entropy device if it has been loaded. If the entropy device is not loaded, then the -.Ar buffer +.Fa buffer is filled with output generated by .Fn random . The -.Ar buffer +.Fa buffer is filled with no more than -.Ar count +.Fa count bytes. It is advised that .Fn read_random is not used; instead use -.Fn arc4rand +.Fn arc4rand .Pp All the bits generated by .Fn random , @@ -133,7 +134,7 @@ bytes. The .Fn arc4random function -uses +uses .Fn arc4rand to generate pseudo-random numbers in the range from 0 to .if t 2\u\s732\s10\d\(mi1. @@ -142,7 +143,7 @@ to generate pseudo-random numbers in the range from 0 to The .Fn read_random function returns the number of bytes placed in -.Ar buffer . +.Fa buffer . .Sh AUTHORS .An Dan Moschuk wrote diff --git a/share/man/man9/style.9 b/share/man/man9/style.9 index fabb1a4..101b4a2 100644 --- a/share/man/man9/style.9 +++ b/share/man/man9/style.9 @@ -195,7 +195,9 @@ greater than 20 lines, or where a series of nested .Ic #ifdef 's may be confusing to the reader. Exceptions may be made for cases where code is conditionally not compiled for -the purposes of lint, even though the uncompiled region may be small. +the purposes of +.Xr lint 1 , +even though the uncompiled region may be small. The comment should be separated from the .Ic #endif or @@ -252,8 +254,11 @@ enum enumtype { ONE, TWO } et; .Pp In declarations, do not put any whitespace between asterisks and adjacent tokens, except for tokens that are identifiers related to -types. (These identifiers are the names of basic types, type -qualifiers, and typedef-names other than the one being declared.) +types. +(These identifiers are the names of basic types, type +qualifiers, and +.Ic typedef Ns -names +other than the one being declared.) Separate these identifers from asterisks using a single space. .Pp When declaring variables in structures, declare them sorted by use, then diff --git a/share/man/man9/swi.9 b/share/man/man9/swi.9 index 2f0faa9..2944a40 100644 --- a/share/man/man9/swi.9 +++ b/share/man/man9/swi.9 @@ -136,7 +136,7 @@ when scheduling a software interrupt handler can be used to implement the functionality performed by .Fn setdelayed in earlier versions of -.Fx . +.Fx . .El .Pp The diff --git a/share/man/man9/zone.9 b/share/man/man9/zone.9 index 48309b6..43076b9 100644 --- a/share/man/man9/zone.9 +++ b/share/man/man9/zone.9 @@ -101,9 +101,11 @@ the uma subsystem at the time of the call to .Fn uma_zalloc and .Fn uma_zfree -respectively. Their purpose is to provide hooks for initializing or +respectively. +Their purpose is to provide hooks for initializing or destroying things that need to be done at the time of the allocation -or release of a resource. A good useage for the +or release of a resource. +A good useage for the .Fa ctor and .Fa dtor @@ -115,13 +117,20 @@ The and .Fa fini arguments are used to optimize the allocation of -objects from the zone. They are called by the uma subsystem whenever +objects from the zone. +They are called by the uma subsystem whenever it needs to allocate or free several items to satisfy requests or memory -pressure. A good use for the uminit and fini callbacks might be to -initialize and destroy mutexes contained within the object. This would +pressure. +A good use for the +.Fa uminit +and +.Fa fini +callbacks might be to +initialize and destroy mutexes contained within the object. +This would allow one to re-use already initialized mutexes when an object is returned -from the uma subsystem's object cache. They are not called on each call -to +from the uma subsystem's object cache. +They are not called on each call to .Fn uma_zalloc and .Fn uma_zfree |