Sweep-fix man page section order to match mdoc(7), part 2/5.
authorSascha Wildner <swildner@dragonflybsd.org>
Fri, 17 Feb 2006 19:35:07 +0000 (19:35 +0000)
committerSascha Wildner <swildner@dragonflybsd.org>
Fri, 17 Feb 2006 19:35:07 +0000 (19:35 +0000)
Note: I haven't touched the few man pages that are still using
      the old man(7) macros. They will be converted to mdoc later.

103 files changed:
lib/libalias/libalias.3
lib/libc/compat-43/gethostid.3
lib/libc/compat-43/setruid.3
lib/libc/compat-43/sigvec.2
lib/libc/gen/dlinfo.3
lib/libc/gen/exec.3
lib/libc/gen/getbootfile.3
lib/libc/gen/getdomainname.3
lib/libc/gen/getgrent.3
lib/libc/gen/gethostname.3
lib/libc/gen/getnetgrent.3
lib/libc/gen/getpwent.3
lib/libc/gen/getvfsent.3
lib/libc/gen/msgrcv.3
lib/libc/gen/msgsnd.3
lib/libc/gen/popen.3
lib/libc/gen/rand48.3
lib/libc/gen/readpassphrase.3
lib/libc/gen/shm_open.3
lib/libc/gen/sysconf.3
lib/libc/gen/sysctl.3
lib/libc/gen/utime.3
lib/libc/net/ethers.3
lib/libc/net/eui64.3
lib/libc/net/getifaddrs.3
lib/libc/net/getipnodebyname.3
lib/libc/net/inet6_option_space.3
lib/libc/net/inet6_rthdr_space.3
lib/libc/net/rcmdsh.3
lib/libc/regex/regex.3
lib/libc/rpc/getrpcent.3
lib/libc/stdio/mktemp.3
lib/libc/stdio/stdio.3
lib/libc/stdlib/getenv.3
lib/libc/stdlib/getopt.3
lib/libc/stdlib/getopt_long.3
lib/libc/stdlib/hcreate.3
lib/libc/stdlib/malloc.3
lib/libc/stdlib/qsort.3
lib/libc/stdlib/random.3
lib/libc/stdlib/tsearch.3
lib/libc/stdtime/strptime.3
lib/libc/string/strtok.3
lib/libc/sys/aio_cancel.2
lib/libc/sys/aio_return.2
lib/libc/sys/aio_suspend.2
lib/libc/sys/brk.2
lib/libc/sys/getlogin.2
lib/libc/sys/getpgrp.2
lib/libc/sys/getrusage.2
lib/libc/sys/getsockname.2
lib/libc/sys/getsockopt.2
lib/libc/sys/lseek.2
lib/libc/sys/mlock.2
lib/libc/sys/mount.2
lib/libc/sys/poll.2
lib/libc/sys/quotactl.2
lib/libc/sys/reboot.2
lib/libc/sys/rfork.2
lib/libc/sys/rtprio.2
lib/libc/sys/select.2
lib/libc/sys/send.2
lib/libc/sys/setpgid.2
lib/libc/sys/sigaction.2
lib/libc/sys/socketpair.2
lib/libc/sys/stat.2
lib/libc/sys/swapon.2
lib/libc/sys/sync.2
lib/libc/sys/sys_checkpoint.2
lib/libc/sys/syscall.2
lib/libc/sys/tls.2
lib/libc/sys/truncate.2
lib/libc/sys/umtx.2
lib/libc/sys/vfork.2
lib/libc/sys/wait.2
lib/libc_r/man/pthread_attr_get_np.3
lib/libc_r/man/pthread_rwlock_destroy.3
lib/libc_r/man/pthread_rwlock_init.3
lib/libc_r/man/pthread_rwlock_rdlock.3
lib/libc_r/man/pthread_rwlock_unlock.3
lib/libc_r/man/pthread_rwlock_wrlock.3
lib/libc_r/man/pthread_rwlockattr_destroy.3
lib/libc_r/man/pthread_rwlockattr_getpshared.3
lib/libc_r/man/pthread_rwlockattr_init.3
lib/libc_r/man/pthread_rwlockattr_setpshared.3
lib/libcrypt/crypt.3
lib/libftpio/ftpio.3
lib/libkvm/kvm_geterr.3
lib/libkvm/kvm_getfiles.3
lib/libkvm/kvm_getprocs.3
lib/libkvm/kvm_open.3
lib/libmd/mdX.3
lib/libmd/ripemd.3
lib/libmd/sha.3
lib/libskey/skey.3
lib/libskey/skey.access.5
lib/libstand/libstand.3
lib/libusbhid/usbhid.3
lib/libutil/_secure_path.3
lib/libutil/auth.3
lib/libutil/login.conf.5
lib/libutil/property.3
lib/libvgl/vgl.3

index 0f76ba5..44b1949 100644 (file)
@@ -24,7 +24,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libalias/libalias.3,v 1.23.2.11 2001/12/17 10:08:22 ru Exp $
-.\" $DragonFly: src/lib/libalias/libalias.3,v 1.2 2003/06/17 04:26:41 dillon Exp $
+.\" $DragonFly: src/lib/libalias/libalias.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 13, 2000
 .Dt LIBALIAS 3
@@ -846,11 +846,6 @@ is provided for error checking purposes.
 This function can be used if an already-aliased packet needs to have its
 original IP header restored for further processing (eg. logging).
 .Ed
-.Sh BUGS
-PPTP aliasing does not work when more than one internal client
-connects to the same external server at the same time, because
-PPTP requires a single TCP control connection to be established
-between any two IP addresses.
 .Sh AUTHORS
 .An Charles Mott Aq cm@linktel.net ,
 versions 1.0 - 1.8, 2.0 - 2.4.
@@ -980,3 +975,8 @@ If this results in a conflict, then port numbers are randomly chosen until
 a unique aliasing link can be established.
 In an alternate operating mode, the first choice of an aliasing port is also
 random and unrelated to the local port number.
+.Sh BUGS
+PPTP aliasing does not work when more than one internal client
+connects to the same external server at the same time, because
+PPTP requires a single TCP control connection to be established
+between any two IP addresses.
index 40d522f..ab51876 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)gethostid.3        8.1 (Berkeley) 6/2/93
 .\" $FreeBSD: src/lib/libc/compat-43/gethostid.3,v 1.5.2.6 2003/03/15 15:11:05 trhodes Exp $
-.\" $DragonFly: src/lib/libc/compat-43/gethostid.3,v 1.2 2003/06/17 04:26:41 dillon Exp $
+.\" $DragonFly: src/lib/libc/compat-43/gethostid.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 2, 1993
 .Dt GETHOSTID 3
@@ -70,8 +70,6 @@ The hostid should be set or retrieved by use of
 .Xr gethostname 3 ,
 .Xr sysctl 3 ,
 .Xr sysctl 8
-.Sh BUGS
-32 bits for the identifier is too small.
 .Sh HISTORY
 The
 .Fn gethostid
@@ -81,3 +79,5 @@ syscalls appeared in
 .Bx 4.2
 and were dropped in
 .Bx 4.4 .
+.Sh BUGS
+32 bits for the identifier is too small.
index 3d39f81..c36404e 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)setruid.3  8.1 (Berkeley) 6/2/93
 .\" $FreeBSD: src/lib/libc/compat-43/setruid.3,v 1.5.2.5 2001/12/14 18:33:49 ru Exp $
-.\" $DragonFly: src/lib/libc/compat-43/setruid.3,v 1.2 2003/06/17 04:26:41 dillon Exp $
+.\" $DragonFly: src/lib/libc/compat-43/setruid.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 2, 1993
 .Dt SETRUID 3
@@ -57,6 +57,9 @@ sets the real user ID (group ID) of the
 current process.
 .Sh RETURN VALUES
 .Rv -std
+.Sh COMPATIBILITY
+The use of these calls is not portable.
+Their use is discouraged; they will be removed in the future.
 .Sh ERRORS
 The functions fail if:
 .Bl -tag -width Er
@@ -64,9 +67,6 @@ The functions fail if:
 The user is not the super user and the ID
 specified is not the real or effective ID.
 .El
-.Sh COMPATIBILITY
-The use of these calls is not portable.
-Their use is discouraged; they will be removed in the future.
 .Sh SEE ALSO
 .Xr getgid 2 ,
 .Xr getuid 2 ,
index 52469c1..02ba217 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)sigvec.2   8.2 (Berkeley) 4/19/94
 .\" $FreeBSD: src/lib/libc/compat-43/sigvec.2,v 1.9.2.8 2003/03/15 15:11:05 trhodes Exp $
-.\" $DragonFly: src/lib/libc/compat-43/sigvec.2,v 1.2 2003/06/17 04:26:41 dillon Exp $
+.\" $DragonFly: src/lib/libc/compat-43/sigvec.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 19, 1994
 .Dt SIGVEC 2
@@ -261,6 +261,39 @@ flag is not available in
 hence it should not be used if backward compatibility is needed.
 .Sh RETURN VALUES
 .Rv -std sigvec
+.Sh EXAMPLES
+On the
+.Tn VAX\-11
+The handler routine can be declared:
+.Bd -literal -offset indent
+void handler(sig, code, scp)
+int sig, code;
+struct sigcontext *scp;
+.Ed
+.Pp
+Here
+.Fa sig
+is the signal number, into which the hardware faults and traps are
+mapped as defined below.
+The
+.Fa code
+argument
+is either a constant
+as given below or, for compatibility mode faults, the code provided by
+the hardware (Compatibility mode faults are distinguished from the
+other
+.Dv SIGILL
+traps by having
+.Dv PSL_CM
+set in the psl).
+The
+.Fa scp
+argument
+is a pointer to the
+.Fa sigcontext
+structure (defined in
+.Aq Pa signal.h ) ,
+used to restore the context from before the signal.
 .Sh ERRORS
 The
 .Fn sigvec
@@ -302,38 +335,5 @@ or
 .Xr signal 3 ,
 .Xr sigsetops 3 ,
 .Xr tty 4
-.Sh EXAMPLES
-On the
-.Tn VAX\-11
-The handler routine can be declared:
-.Bd -literal -offset indent
-void handler(sig, code, scp)
-int sig, code;
-struct sigcontext *scp;
-.Ed
-.Pp
-Here
-.Fa sig
-is the signal number, into which the hardware faults and traps are
-mapped as defined below.
-The
-.Fa code
-argument
-is either a constant
-as given below or, for compatibility mode faults, the code provided by
-the hardware (Compatibility mode faults are distinguished from the
-other
-.Dv SIGILL
-traps by having
-.Dv PSL_CM
-set in the psl).
-The
-.Fa scp
-argument
-is a pointer to the
-.Fa sigcontext
-structure (defined in
-.Aq Pa signal.h ) ,
-used to restore the context from before the signal.
 .Sh BUGS
 This manual page is still confusing.
index ccbb8a7..28fa28c 100644 (file)
@@ -24,7 +24,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/gen/dlinfo.3,v 1.3.2.1 2003/02/20 20:42:45 kan Exp $
-.\" $DragonFly: src/lib/libc/gen/dlinfo.3,v 1.4 2005/12/10 00:22:28 swildner Exp $
+.\" $DragonFly: src/lib/libc/gen/dlinfo.3,v 1.5 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd February 14, 2003
 .Os
@@ -182,6 +182,12 @@ argument is filled with
 pointer
 .Ft ( char *p ) .
 .El
+.Sh RETURN VALUES
+.Fn dlinfo
+returns 0 on success, or -1 if error occured.
+Whenever an error has been detected, a message detailing it can
+be retrieved via a call to
+.Fn dlerror .
 .Sh EXAMPLES
 Example 1: Using
 .Fn dlinfo
@@ -231,12 +237,6 @@ For simplicity, error checking has been omitted.
           (void) printf("%2d: %s\en", cnt, path->dls_name);
       }
 .Ed
-.Sh RETURN VALUES
-.Fn dlinfo
-returns 0 on success, or -1 if error occured.
-Whenever an error has been detected, a message detailing it can
-be retrieved via a call to
-.Fn dlerror .
 .Sh SEE ALSO
 .Xr rtld 1 ,
 .Xr dladdr 3 ,
index bcb77e2..c7e5534 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)exec.3     8.3 (Berkeley) 1/24/94
 .\" $FreeBSD: src/lib/libc/gen/exec.3,v 1.7.2.8 2003/03/15 15:11:05 trhodes Exp $
-.\" $DragonFly: src/lib/libc/gen/exec.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/exec.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd January 24, 1994
 .Dt EXEC 3
@@ -203,37 +203,6 @@ will be set to indicate the error.
 .It Pa /bin/sh
 The shell.
 .El
-.Sh ERRORS
-The
-.Fn execl ,
-.Fn execle ,
-.Fn execlp
-and
-.Fn execvp
-functions
-may fail and set
-.Va errno
-for any of the errors specified for the library functions
-.Xr execve 2
-and
-.Xr malloc 3 .
-.Pp
-The
-.Fn exect
-and
-.Fn execv
-functions
-may fail and set
-.Va errno
-for any of the errors specified for the library function
-.Xr execve 2 .
-.Sh SEE ALSO
-.Xr sh 1 ,
-.Xr execve 2 ,
-.Xr fork 2 ,
-.Xr ktrace 2 ,
-.Xr ptrace 2 ,
-.Xr environ 7
 .Sh COMPATIBILITY
 Historically, the default path for the
 .Fn execlp
@@ -290,6 +259,37 @@ and the unusual error
 .Er EIO .
 The behaviour was changed to match the behaviour of
 .Xr sh 1 .
+.Sh ERRORS
+The
+.Fn execl ,
+.Fn execle ,
+.Fn execlp
+and
+.Fn execvp
+functions
+may fail and set
+.Va errno
+for any of the errors specified for the library functions
+.Xr execve 2
+and
+.Xr malloc 3 .
+.Pp
+The
+.Fn exect
+and
+.Fn execv
+functions
+may fail and set
+.Va errno
+for any of the errors specified for the library function
+.Xr execve 2 .
+.Sh SEE ALSO
+.Xr sh 1 ,
+.Xr execve 2 ,
+.Xr fork 2 ,
+.Xr ktrace 2 ,
+.Xr ptrace 2 ,
+.Xr environ 7
 .Sh STANDARDS
 The
 .Fn execl ,
index e8c483c..73a6d0c 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     From: @(#)gethostname.3        8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/gen/getbootfile.3,v 1.6.2.3 2001/12/14 18:33:51 ru Exp $
-.\" $DragonFly: src/lib/libc/gen/getbootfile.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/getbootfile.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd September 23, 1994
 .Dt GETBOOTFILE 3
@@ -61,13 +61,14 @@ placed in the global location
 .Va errno .
 .Sh SEE ALSO
 .Xr sysctl 3
-.Sh BUGS
-If the boot blocks have not been modified to pass this information into
-the kernel at boot time, the static string
-.Dq Pa /kernel
-is returned instead of the real boot file.
 .Sh HISTORY
 The
 .Fn getbootfile
 function call appeared in
 .Fx 2.0 .
+.Sh BUGS
+If the boot blocks have not been modified to pass this information into
+the kernel at boot time, the static string
+.Dq Pa /kernel
+is returned instead of the real boot file.
+
index b81b949..fcab6ce 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)gethostname.3      8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/gen/getdomainname.3,v 1.9.2.5 2001/12/14 18:33:51 ru Exp $
-.\" $DragonFly: src/lib/libc/gen/getdomainname.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/getdomainname.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd May 6, 1994
 .Dt GETDOMAINNAME 3
@@ -86,14 +86,14 @@ The caller tried to set the hostname and was not the super-user.
 .Xr gethostid 3 ,
 .Xr gethostname 3 ,
 .Xr sysctl 3
+.Sh HISTORY
+The
+.Fn getdomainname
+function call appeared in
+.Bx 4.2 .
 .Sh BUGS
 Domain names are limited to
 .Dv MAXHOSTNAMELEN
 (from
 .Ao Pa sys/param.h Ac )
 characters, currently 256.
-.Sh HISTORY
-The
-.Fn getdomainname
-function call appeared in
-.Bx 4.2 .
index 70f082a..aa784c6 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     From: @(#)getgrent.3   8.2 (Berkeley) 4/19/94
 .\" $FreeBSD: src/lib/libc/gen/getgrent.3,v 1.12.2.4 2003/03/15 15:11:05 trhodes Exp $
-.\" $DragonFly: src/lib/libc/gen/getgrent.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/getgrent.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd September 29, 1994
 .Dt GETGRENT 3
@@ -169,6 +169,11 @@ have no return value.
 .It Pa /etc/group
 group database file
 .El
+.Sh COMPATIBILITY
+The historic function
+.Fn setgrfile ,
+which allowed the specification of alternate password databases, has
+been deprecated and is no longer available.
 .Sh SEE ALSO
 .Xr getpwent 3 ,
 .Xr group 5 ,
@@ -189,11 +194,6 @@ and
 .Fn setgroupent
 appeared in
 .Bx 4.3 Reno .
-.Sh COMPATIBILITY
-The historic function
-.Fn setgrfile ,
-which allowed the specification of alternate password databases, has
-been deprecated and is no longer available.
 .Sh BUGS
 The functions
 .Fn getgrent ,
index 6049b3a..936e481 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)gethostname.3      8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/gen/gethostname.3,v 1.5.2.6 2003/03/13 18:05:37 trhodes Exp $
-.\" $DragonFly: src/lib/libc/gen/gethostname.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/gethostname.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt GETHOSTNAME 3
@@ -90,6 +90,11 @@ The caller tried to set the hostname and was not the super-user.
 .Sh SEE ALSO
 .Xr gethostid 3 ,
 .Xr sysctl 3
+.Sh HISTORY
+The
+.Fn gethostname
+function appeared in
+.Bx 4.2 .
 .Sh BUGS
 Host names are limited to
 .Dv MAXHOSTNAMELEN
@@ -98,8 +103,3 @@ Host names are limited to
 characters, currently 256.
 This includes the trailing
 .Dv NUL .
-.Sh HISTORY
-The
-.Fn gethostname
-function appeared in
-.Bx 4.2 .
index 710c832..e5ea06b 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)getnetgrent.3      8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/gen/getnetgrent.3,v 1.6.2.5 2003/03/13 18:05:37 trhodes Exp $
-.\" $DragonFly: src/lib/libc/gen/getnetgrent.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/getnetgrent.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt GETNETGRENT 3
@@ -119,14 +119,14 @@ have no return value.
 .It Pa /etc/netgroup
 netgroup database file
 .El
-.Sh SEE ALSO
-.Xr netgroup 5
 .Sh COMPATIBILITY
 The netgroup members have three string fields to maintain compatibility
 with other vendor implementations, however it is not obvious what use the
 .Sy domain
 string has within
 .Bx .
+.Sh SEE ALSO
+.Xr netgroup 5
 .Sh BUGS
 The function
 .Fn getnetgrent
index 2b4936f..df97b7f 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     From: @(#)getpwent.3   8.2 (Berkeley) 12/11/93
 .\" $FreeBSD: src/lib/libc/gen/getpwent.3,v 1.11.2.5 2002/02/01 15:51:16 ru Exp $
-.\" $DragonFly: src/lib/libc/gen/getpwent.3,v 1.3 2005/08/01 01:49:16 swildner Exp $
+.\" $DragonFly: src/lib/libc/gen/getpwent.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd September 20, 1994
 .Dt GETPWENT 3
@@ -184,6 +184,11 @@ The current password file
 .It Pa /etc/passwd
 A Version 7 format password file
 .El
+.Sh COMPATIBILITY
+The historic function
+.Xr setpwfile 3 ,
+which allowed the specification of alternate password databases,
+has been deprecated and is no longer available.
 .Sh SEE ALSO
 .Xr getlogin 2 ,
 .Xr getgrent 3 ,
@@ -205,11 +210,6 @@ The
 .Fn setpassent
 function appeared in
 .Bx 4.3 Reno .
-.Sh COMPATIBILITY
-The historic function
-.Xr setpwfile 3 ,
-which allowed the specification of alternate password databases,
-has been deprecated and is no longer available.
 .Sh BUGS
 The functions
 .Fn getpwent ,
index 60e7563..a3bc2e3 100644 (file)
@@ -1,5 +1,5 @@
 .\" $FreeBSD: src/lib/libc/gen/getvfsent.3,v 1.17.2.5 2001/12/14 18:33:51 ru Exp $
-.\" $DragonFly: src/lib/libc/gen/getvfsent.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/getvfsent.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"    Written by Garrett A. Wollman, September 1994.
 .\"    This manual page is in the public domain.
 .\"
@@ -171,14 +171,14 @@ may be set to one of the values documented for
 .Xr kldload 2 ,
 .Xr mount 2 ,
 .Xr mount 8
+.Sh HISTORY
+The
+.Fn getvfsent
+family of functions first appeared in
+.Fx 2.0 .
 .Sh AUTHORS
 .An -nosplit
 The loadable filesystem support was written by
 .An Garrett A. Wollman ,
 based on generic loadable kernel module support by
 .An Terry Lambert .
-.Sh HISTORY
-The
-.Fn getvfsent
-family of functions first appeared in
-.Fx 2.0 .
index 8d7e594..db5b992 100644 (file)
@@ -29,7 +29,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\" $FreeBSD: src/lib/libc/gen/msgrcv.3,v 1.8.2.7 2003/03/15 15:11:05 trhodes Exp $
-.\" $DragonFly: src/lib/libc/gen/msgrcv.3,v 1.3 2004/03/11 12:28:50 hmp Exp $
+.\" $DragonFly: src/lib/libc/gen/msgrcv.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .\"/
 .Dd November 24, 1997
@@ -214,6 +214,9 @@ is set in
 .Xr msgctl 3 ,
 .Xr msgget 3 ,
 .Xr msgsnd 3
+.Sh HISTORY
+Message queues appeared in the first release of
+.At V .
 .Sh BUGS
 .Tn Nx Ns ,
 .Dx Ns ,
@@ -228,6 +231,3 @@ value, which
 should be used when no suitable message is available and
 .Dv IPC_NOWAIT
 is set.
-.Sh HISTORY
-Message queues appeared in the first release of
-.At V .
index 9c79767..78872dd 100644 (file)
@@ -30,7 +30,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/gen/msgsnd.3,v 1.9.2.5 2001/12/14 18:33:51 ru Exp $
-.\" $DragonFly: src/lib/libc/gen/msgsnd.3,v 1.3 2004/03/11 12:28:50 hmp Exp $
+.\" $DragonFly: src/lib/libc/gen/msgsnd.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd November 24, 1997
 .Dt MSGSND 3
@@ -156,6 +156,8 @@ points to an invalid address.
 .It Bq Er EINTR
 The system call was interrupted by the delivery of a signal.
 .El
+.Sh HISTORY
+Message queues appeared in the first release of AT&T Unix System V.
 .Sh BUGS
 .Nx Ns ,
 .Dx Ns ,
@@ -165,5 +167,3 @@ do not define the
 .Er EIDRM
 error value, which should be used
 in the case of a removed message queue.
-.Sh HISTORY
-Message queues appeared in the first release of AT&T Unix System V.
index bb41f9e..3193f81 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)popen.3    8.2 (Berkeley) 5/3/95
 .\" $FreeBSD: src/lib/libc/gen/popen.3,v 1.10.2.4 2003/03/15 15:11:05 trhodes Exp $
-.\" $DragonFly: src/lib/libc/gen/popen.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/popen.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd May 3, 1995
 .Dt POPEN 3
@@ -165,6 +165,16 @@ function does not reliably set
 .Xr fopen 3 ,
 .Xr stdio 3 ,
 .Xr system 3
+.Sh HISTORY
+A
+.Fn popen
+and a
+.Fn pclose
+function appeared in
+.At v7 .
+.Pp
+Bidirectional functionality was added in
+.Fx 2.2.6 .
 .Sh BUGS
 Since the standard input of a command opened for reading
 shares its seek offset with the process that called
@@ -190,13 +200,3 @@ always calls
 .Xr sh 1 ,
 never calls
 .Xr csh 1 .
-.Sh HISTORY
-A
-.Fn popen
-and a
-.Fn pclose
-function appeared in
-.At v7 .
-.Pp
-Bidirectional functionality was added in
-.Fx 2.2.6 .
index e8557a4..e53fc51 100644 (file)
@@ -11,7 +11,7 @@
 .\"
 .\"     @(#)rand48.3 V1.0 MB 8 Oct 1993
 .\" $FreeBSD: src/lib/libc/gen/rand48.3,v 1.8.2.6 2003/03/15 15:11:05 trhodes Exp $
-.\" $DragonFly: src/lib/libc/gen/rand48.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/rand48.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd October 8, 1993
 .Dt RAND48 3
@@ -175,8 +175,8 @@ generator calls.
 .Pp
 For a more powerful random number generator, see
 .Xr random 3 .
-.Sh AUTHORS
-.An Martin Birgmeier
 .Sh SEE ALSO
 .Xr rand 3 ,
 .Xr random 3
+.Sh AUTHORS
+.An Martin Birgmeier
index 04349ca..f648d63 100644 (file)
@@ -26,7 +26,7 @@
 .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/gen/readpassphrase.3,v 1.4.2.3 2003/03/15 15:11:05 trhodes Exp $
-.\" $DragonFly: src/lib/libc/gen/readpassphrase.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/readpassphrase.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd December 7, 2001
 .Dt READPASSPHRASE 3
@@ -93,6 +93,31 @@ If an error is encountered, the terminal state is restored and
 a
 .Dv NULL
 pointer is returned.
+.Sh FILES
+.Bl -tag -width ".Pa /dev/tty" -compact
+.It Pa /dev/tty
+.El
+.Sh EXAMPLES
+The following code fragment will read a passphrase from
+.Pa /dev/tty
+into the buffer
+.Fa passbuf .
+.Bd -literal -offset indent
+char passbuf[1024];
+
+\&...
+
+if (readpassphrase("Response: ", passbuf, sizeof(passbuf),
+    RPP_REQUIRE_TTY) == NULL)
+       errx(1, "unable to read passphrase");
+
+if (compare(transform(passbuf), epass) != 0)
+       errx(1, "bad passphrase");
+
+\&...
+
+memset(passbuf, 0, sizeof(passbuf));
+.Ed
 .Sh ERRORS
 .Bl -tag -width Er
 .It Bq Er EINTR
@@ -118,27 +143,6 @@ There is no controlling terminal and the
 .Dv RPP_REQUIRE_TTY
 flag was specified.
 .El
-.Sh EXAMPLES
-The following code fragment will read a passphrase from
-.Pa /dev/tty
-into the buffer
-.Fa passbuf .
-.Bd -literal -offset indent
-char passbuf[1024];
-
-\&...
-
-if (readpassphrase("Response: ", passbuf, sizeof(passbuf),
-    RPP_REQUIRE_TTY) == NULL)
-       errx(1, "unable to read passphrase");
-
-if (compare(transform(passbuf), epass) != 0)
-       errx(1, "bad passphrase");
-
-\&...
-
-memset(passbuf, 0, sizeof(passbuf));
-.Ed
 .Sh SIGNALS
 The
 .Fn readpassphrase
@@ -173,10 +177,6 @@ from a background process) are treated specially.
 When the process is resumed after it has been stopped,
 .Fn readpassphrase
 will reprint the prompt and the user may then enter a passphrase.
-.Sh FILES
-.Bl -tag -width ".Pa /dev/tty" -compact
-.It Pa /dev/tty
-.El
 .Sh SEE ALSO
 .Xr sigaction 2 ,
 .Xr getpass 3
index dba724a..d234567 100644 (file)
@@ -27,7 +27,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/gen/shm_open.3,v 1.3.2.5 2001/12/14 18:33:51 ru Exp $
-.\" $DragonFly: src/lib/libc/gen/shm_open.3,v 1.3 2004/03/11 12:28:50 hmp Exp $
+.\" $DragonFly: src/lib/libc/gen/shm_open.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd March 24, 2000
 .Dt SHM_OPEN 3
@@ -101,6 +101,15 @@ The
 function makes no effort to ensure that
 .Fa path
 refers to a shared memory object.
+.Sh RETURN VALUES
+If successful,
+.Fn shm_open
+returns a non-negative integer;
+.Fn shm_unlink
+returns zero.
+Both functions return -1 on failure, and set
+.Va errno
+to indicate the error.
 .Sh COMPATIBILITY
 The
 .Fa path
@@ -133,15 +142,6 @@ on a shared memory object, or on the descriptor returned by
 is undefined.
 It is also undefined whether the shared memory object itself, or its
 contents, persist across reboots.
-.Sh RETURN VALUES
-If successful,
-.Fn shm_open
-returns a non-negative integer;
-.Fn shm_unlink
-returns zero.
-Both functions return -1 on failure, and set
-.Va errno
-to indicate the error.
 .Sh ERRORS
 The
 .Fn shm_open
index 2db886f..3f195ba 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"    @(#)sysconf.3   8.3 (Berkeley) 4/19/94
 .\" $FreeBSD: src/lib/libc/gen/sysconf.3,v 1.8.2.6 2001/12/14 18:33:51 ru Exp $
-.\" $DragonFly: src/lib/libc/gen/sysconf.3,v 1.3 2004/11/09 17:52:45 joerg Exp $
+.\" $DragonFly: src/lib/libc/gen/sysconf.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 19, 1994
 .Dt SYSCONF 3
@@ -186,10 +186,6 @@ argument is invalid.
 .El
 .Sh SEE ALSO
 .Xr sysctl 3
-.Sh BUGS
-The value for _SC_STREAM_MAX is a minimum maximum, and required to be
-the same as ANSI C's FOPEN_MAX, so the returned value is a ridiculously
-small and misleading number.
 .Sh STANDARDS
 Except for the fact that values returned by
 .Fn sysconf
@@ -201,3 +197,7 @@ The
 .Fn sysconf
 function first appeared in
 .Bx 4.4 .
+.Sh BUGS
+The value for _SC_STREAM_MAX is a minimum maximum, and required to be
+the same as ANSI C's FOPEN_MAX, so the returned value is a ridiculously
+small and misleading number.
index 74e4d67..1647c5d 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"    @(#)sysctl.3    8.4 (Berkeley) 5/9/95
 .\" $FreeBSD: src/lib/libc/gen/sysctl.3,v 1.33.2.13 2002/04/07 04:57:14 dd Exp $
-.\" $DragonFly: src/lib/libc/gen/sysctl.3,v 1.3 2004/04/22 16:52:55 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/sysctl.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd January 23, 2001
 .Dt SYSCTL 3
@@ -744,6 +744,27 @@ pageout daemon will enter "memory conserving mode" to avoid deadlock.
 .El
 .Sh RETURN VALUES
 .Rv -std
+.Sh FILES
+.Bl -tag -width <netinet/icmpXvar.h> -compact
+.It Aq Pa sys/sysctl.h
+definitions for top level identifiers, second level kernel and hardware
+identifiers, and user level identifiers
+.It Aq Pa sys/socket.h
+definitions for second level network identifiers
+.It Aq Pa sys/gmon.h
+definitions for third level profiling identifiers
+.It Aq Pa vm/vm_param.h
+definitions for second level virtual memory identifiers
+.It Aq Pa netinet/in.h
+definitions for third level IPv4/IPv6 identifiers and
+fourth level IPv4/v6 identifiers
+.It Aq Pa netinet/icmp_var.h
+definitions for fourth level ICMP identifiers
+.It Aq Pa netinet/icmp6.h
+definitions for fourth level ICMPv6 identifiers
+.It Aq Pa netinet/udp_var.h
+definitions for fourth level UDP identifiers
+.El
 .Sh ERRORS
 The following errors may be reported:
 .Bl -tag -width Er
@@ -786,27 +807,6 @@ An attempt is made to set a read-only value.
 .It Bq Er EPERM
 A process without appropriate privilege attempts to set a value.
 .El
-.Sh FILES
-.Bl -tag -width <netinet/icmpXvar.h> -compact
-.It Aq Pa sys/sysctl.h
-definitions for top level identifiers, second level kernel and hardware
-identifiers, and user level identifiers
-.It Aq Pa sys/socket.h
-definitions for second level network identifiers
-.It Aq Pa sys/gmon.h
-definitions for third level profiling identifiers
-.It Aq Pa vm/vm_param.h
-definitions for second level virtual memory identifiers
-.It Aq Pa netinet/in.h
-definitions for third level IPv4/IPv6 identifiers and
-fourth level IPv4/v6 identifiers
-.It Aq Pa netinet/icmp_var.h
-definitions for fourth level ICMP identifiers
-.It Aq Pa netinet/icmp6.h
-definitions for fourth level ICMPv6 identifiers
-.It Aq Pa netinet/udp_var.h
-definitions for fourth level UDP identifiers
-.El
 .Sh SEE ALSO
 .Xr sysconf 3 ,
 .Xr sysctl 8
index d6c71fe..386db12 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)utime.3    8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/gen/utime.3,v 1.5.2.4 2001/12/14 18:33:51 ru Exp $
-.\" $DragonFly: src/lib/libc/gen/utime.3,v 1.2 2003/06/17 04:26:42 dillon Exp $
+.\" $DragonFly: src/lib/libc/gen/utime.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt UTIME 3
@@ -80,13 +80,13 @@ for any of the errors specified for the library function
 .Sh SEE ALSO
 .Xr stat 2 ,
 .Xr utimes 2
-.Sh HISTORY
-A
-.Fn utime
-function appeared in
-.At v7 .
 .Sh STANDARDS
 The
 .Fn utime
 function conforms to
 .St -p1003.1-88 .
+.Sh HISTORY
+A
+.Fn utime
+function appeared in
+.At v7 .
index d6845c1..0334971 100644 (file)
@@ -29,7 +29,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/net/ethers.3,v 1.10.2.11 2002/02/01 15:51:17 ru Exp $
-.\" $DragonFly: src/lib/libc/net/ethers.3,v 1.2 2003/06/17 04:26:44 dillon Exp $
+.\" $DragonFly: src/lib/libc/net/ethers.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 12, 1995
 .Dt ETHERS 3
@@ -184,6 +184,11 @@ file.
 .Sh SEE ALSO
 .Xr ethers 5 ,
 .Xr yp 8
+.Sh HISTORY
+This particular implementation of the
+.Nm
+library functions were written for and first appeared in
+.Fx 2.1 .
 .Sh BUGS
 The
 .Fn ether_aton
@@ -191,8 +196,3 @@ and
 .Fn ether_ntoa
 functions returns values that are stored in static memory areas
 which may be overwritten the next time they are called.
-.Sh HISTORY
-This particular implementation of the
-.Nm
-library functions were written for and first appeared in
-.Fx 2.1 .
index 195557c..405bd70 100644 (file)
@@ -55,7 +55,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/net/eui64.3,v 1.3 2004/07/07 20:15:31 ru Exp $
-.\" $DragonFly: src/lib/libc/net/eui64.3,v 1.2 2004/12/26 12:37:07 swildner Exp $
+.\" $DragonFly: src/lib/libc/net/eui64.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd March 4, 2004
 .Dt EUI64 3
@@ -216,6 +216,12 @@ file.
 .Xr firewire 4 ,
 .Xr eui64 5 ,
 .Xr yp 8
+.Sh HISTORY
+These functions first appears in
+.Fx 5.3 .
+They are derived from the
+.Xr ethers 3
+family of functions.
 .Sh BUGS
 The
 .Fn eui64_aton
@@ -223,9 +229,3 @@ and
 .Fn eui64_ntoa
 functions returns values that are stored in static memory areas
 which may be overwritten the next time they are called.
-.Sh HISTORY
-These functions first appears in
-.Fx 5.3 .
-They are derived from the
-.Xr ethers 3
-family of functions.
index 5a0d27b..d6e3460 100644 (file)
@@ -1,5 +1,5 @@
 .\"    $FreeBSD: src/lib/libc/net/getifaddrs.3,v 1.1.2.5 2001/12/14 18:33:55 ru Exp $
-.\"    $DragonFly: src/lib/libc/net/getifaddrs.3,v 1.2 2003/06/17 04:26:44 dillon Exp $
+.\"    $DragonFly: src/lib/libc/net/getifaddrs.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"    $KAME: getifaddrs.3,v 1.4 2000/05/17 14:13:14 itojun Exp $
 .\"    BSDI    getifaddrs.3,v 2.5 2000/02/23 14:51:59 dab Exp
 .\"
@@ -142,16 +142,6 @@ for any of the errors specified for the library routines
 .Xr malloc 3
 or
 .Xr sysctl 3 .
-.Sh BUGS
-If both
-.Aq Pa net/if.h
-and
-.Aq Pa ifaddrs.h
-are being included,
-.Aq Pa net/if.h
-.Em must
-be included before
-.Aq Pa ifaddrs.h .
 .Sh SEE ALSO
 .Xr ioctl 2 ,
 .Xr socket 2 ,
@@ -163,3 +153,13 @@ The
 .Nm
 implementation first appeared in BSDi
 .Bsx .
+.Sh BUGS
+If both
+.Aq Pa net/if.h
+and
+.Aq Pa ifaddrs.h
+are being included,
+.Aq Pa net/if.h
+.Em must
+be included before
+.Aq Pa ifaddrs.h .
index c262aac..ba1b29c 100644 (file)
@@ -1,5 +1,5 @@
 .\"    $FreeBSD: src/lib/libc/net/getipnodebyname.3,v 1.2.2.4 2001/12/14 18:33:55 ru Exp $
-.\"    $DragonFly: src/lib/libc/net/getipnodebyname.3,v 1.2 2003/06/17 04:26:44 dillon Exp $
+.\"    $DragonFly: src/lib/libc/net/getipnodebyname.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"    $KAME: getipnodebyname.3,v 1.6 2000/08/09 21:16:17 itojun Exp $
 .\"
 .\" Copyright (c) 1983, 1987, 1991, 1993
@@ -432,9 +432,6 @@ The meanings of each error code are described in
 .%D March 1999
 .Re
 .\"
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
-.\"
 .Sh STANDARDS
 .Fn getipnodebyname
 and
@@ -443,6 +440,9 @@ are documented in
 .Dq Basic Socket Interface Extensions for IPv6
 (RFC2553).
 .\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
+.\"
 .Sh BUGS
 .Fn getipnodebyname
 and
index c8fda58..9b5c790 100644 (file)
@@ -1,6 +1,6 @@
 .\"    $KAME: inet6_option_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $
 .\"    $FreeBSD: src/lib/libc/net/inet6_option_space.3,v 1.16 2005/01/23 16:02:48 gnn Exp $
-.\"    $DragonFly: src/lib/libc/net/inet6_option_space.3,v 1.4 2005/12/10 00:22:28 swildner Exp $
+.\"    $DragonFly: src/lib/libc/net/inet6_option_space.3,v 1.5 2006/02/17 19:35:06 swildner Exp $
 .\"
 .\" Copyright (C) 2004 WIDE Project.
 .\" All rights reserved.
@@ -377,6 +377,9 @@ function starts searching for an option of the specified type
 beginning after the value of
 .Fa *tptrp .
 .\"
+.Sh EXAMPLES
+RFC2292 gives comprehensive examples in chapter 6.
+.\"
 .Sh DIAGNOSTICS
 The
 .Fn inet6_option_init
@@ -406,9 +409,6 @@ to non
 .Dv NULL
 value.
 .\"
-.Sh EXAMPLES
-RFC2292 gives comprehensive examples in chapter 6.
-.\"
 .Sh SEE ALSO
 .Rs
 .%A W. Stevens
@@ -425,11 +425,11 @@ RFC2292 gives comprehensive examples in chapter 6.
 .%D December 1998
 .Re
 .\"
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
-.\"
 .Sh STANDARDS
 The functions are documented in
 .Dq Advanced Sockets API for IPv6
 (RFC2292).
 .\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
+.\"
index 7a81cda..fe94f1d 100644 (file)
@@ -1,6 +1,6 @@
 .\"    $KAME: inet6_rthdr_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $
 .\"    $FreeBSD: src/lib/libc/net/inet6_rthdr_space.3,v 1.14 2005/01/23 16:02:48 gnn Exp $
-.\"    $DragonFly: src/lib/libc/net/inet6_rthdr_space.3,v 1.3 2005/01/23 17:03:13 hrs Exp $
+.\"    $DragonFly: src/lib/libc/net/inet6_rthdr_space.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .\" Copyright (C) 2004 WIDE Project.
 .\" All rights reserved.
@@ -248,6 +248,9 @@ When an error occurs \-1 is returned.
 Note: Flags begin at index 0 while segments begin at index 1, to
 maintain consistency with the terminology and figures in RFC2460.
 .\"
+.Sh EXAMPLES
+RFC2292 gives comprehensive examples in chapter 8.
+.\"
 .Sh DIAGNOSTICS
 The
 .Fn inet6_rthdr_space
@@ -273,9 +276,6 @@ and
 .Fn inet6_rthdr_getflags
 functions return -1 on error.
 .\"
-.Sh EXAMPLES
-RFC2292 gives comprehensive examples in chapter 8.
-.\"
 .Sh SEE ALSO
 .Rs
 .%A W. Stevens
index fd2e4bf..70d007b 100644 (file)
@@ -32,7 +32,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/net/rcmdsh.3,v 1.2.2.2 2002/06/06 10:53:29 sheldonh Exp $
-.\" $DragonFly: src/lib/libc/net/rcmdsh.3,v 1.2 2003/06/17 04:26:44 dillon Exp $
+.\" $DragonFly: src/lib/libc/net/rcmdsh.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd September 1, 1996
 .Dt RCMDSH 3
@@ -104,10 +104,6 @@ and a diagnostic message is printed on the standard error.
 .Xr socketpair 2 ,
 .Xr rcmd 3 ,
 .Xr rshd 8
-.Sh BUGS
-If
-.Xr rsh 1
-encounters an error, a file descriptor is still returned instead of \-1.
 .Sh HISTORY
 The
 .Fn rcmdsh
@@ -115,3 +111,7 @@ function first appeared in
 .Ox 2.0 ,
 and made its way into
 .Fx 4.6 .
+.Sh BUGS
+If
+.Xr rsh 1
+encounters an error, a file descriptor is still returned instead of \-1.
index d3b5368..26fe57e 100644 (file)
@@ -35,7 +35,7 @@
 .\"
 .\"    @(#)regex.3     8.4 (Berkeley) 3/20/94
 .\" $FreeBSD: src/lib/libc/regex/regex.3,v 1.4.2.4 2001/12/14 18:33:56 ru Exp $
-.\" $DragonFly: src/lib/libc/regex/regex.3,v 1.2 2003/06/17 04:26:44 dillon Exp $
+.\" $DragonFly: src/lib/libc/regex/regex.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd March 20, 1994
 .Dt REGEX 3
@@ -573,14 +573,6 @@ and
 beginning and ending subexpressions in obsolete
 .Pq Dq basic
 REs are anchors, not ordinary characters.
-.Sh SEE ALSO
-.Xr grep 1 ,
-.Xr re_format 7
-.Pp
-.St -p1003.2 ,
-sections 2.8 (Regular Expression Notation)
-and
-B.5 (C Binding for Regular Expression Matching).
 .Sh DIAGNOSTICS
 Non-zero error codes from
 .Fn regcomp
@@ -636,6 +628,14 @@ can't happen - you found a bug
 .It Dv REG_INVARG
 invalid argument, e.g. negative-length string
 .El
+.Sh SEE ALSO
+.Xr grep 1 ,
+.Xr re_format 7
+.Pp
+.St -p1003.2 ,
+sections 2.8 (Regular Expression Notation)
+and
+B.5 (C Binding for Regular Expression Matching).
 .Sh HISTORY
 Originally written by
 .An Henry Spencer .
index 2991d74..c7abb8d 100644 (file)
@@ -1,6 +1,6 @@
 .\" @(#)getrpcent.3n   2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
 .\" $FreeBSD: src/lib/libc/rpc/getrpcent.3,v 1.11.2.3 2001/12/14 18:33:56 ru Exp $
-.\" $DragonFly: src/lib/libc/rpc/getrpcent.3,v 1.2 2003/06/17 04:26:44 dillon Exp $
+.\" $DragonFly: src/lib/libc/rpc/getrpcent.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd December 14, 1987
 .Dt GETRPCENT 3
@@ -82,16 +82,16 @@ program number is found, or until end-of-file is encountered.
 .Bl -tag -width /etc/rpc -compact
 .It Pa /etc/rpc
 .El
-.Sh "SEE ALSO"
-.Xr rpc 5 ,
-.Xr rpcinfo 8 ,
-.Xr ypserv 8
 .Sh DIAGNOSTICS
 A
 .Dv NULL
 pointer is returned on
 .Dv EOF
 or error.
+.Sh "SEE ALSO"
+.Xr rpc 5 ,
+.Xr rpcinfo 8 ,
+.Xr ypserv 8
 .Sh BUGS
 All information
 is contained in a static area
index 177fe3d..1f831c1 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)mktemp.3   8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/stdio/mktemp.3,v 1.11.2.6 2001/12/14 18:33:57 ru Exp $
-.\" $DragonFly: src/lib/libc/stdio/mktemp.3,v 1.2 2003/06/17 04:26:46 dillon Exp $
+.\" $DragonFly: src/lib/libc/stdio/mktemp.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd February 11, 1998
 .Dt MKTEMP 3
@@ -189,6 +189,33 @@ so that it will store string constants in a writable segment of memory.
 See
 .Xr gcc 1
 for more information.
+.Sh SEE ALSO
+.Xr chmod 2 ,
+.Xr getpid 2 ,
+.Xr mkdir 2 ,
+.Xr open 2 ,
+.Xr stat 2
+.Sh HISTORY
+A
+.Fn mktemp
+function appeared in
+.At v7 .
+The
+.Fn mkstemp
+function appeared in
+.Bx 4.4 .
+The
+.Fn mkdtemp
+function first appeared in
+.Ox 2.2 ,
+and later in
+.Fx 3.2 .
+The
+.Fn mkstemps
+function first appeared in
+.Ox 2.4 ,
+and later in
+.Fx 3.4 .
 .Sh BUGS
 This family of functions produces filenames which can be guessed,
 though the risk is minimized when large numbers of
@@ -218,30 +245,3 @@ and the return status of the call should be tested for failure.
 This will ensure that the program does not continue blindly
 in the event that an attacker has already created the file
 with the intention of manipulating or reading its contents.
-.Sh SEE ALSO
-.Xr chmod 2 ,
-.Xr getpid 2 ,
-.Xr mkdir 2 ,
-.Xr open 2 ,
-.Xr stat 2
-.Sh HISTORY
-A
-.Fn mktemp
-function appeared in
-.At v7 .
-The
-.Fn mkstemp
-function appeared in
-.Bx 4.4 .
-The
-.Fn mkdtemp
-function first appeared in
-.Ox 2.2 ,
-and later in
-.Fx 3.2 .
-The
-.Fn mkstemps
-function first appeared in
-.Ox 2.4 ,
-and later in
-.Fx 3.4 .
index 3b29909..51e2ad1 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)stdio.3    8.7 (Berkeley) 4/19/94
 .\" $FreeBSD: src/lib/libc/stdio/stdio.3,v 1.10.2.8 2003/02/19 05:12:44 gshapiro Exp $
-.\" $DragonFly: src/lib/libc/stdio/stdio.3,v 1.2 2003/06/17 04:26:46 dillon Exp $
+.\" $DragonFly: src/lib/libc/stdio/stdio.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 19, 1994
 .Dt STDIO 3
@@ -218,10 +218,6 @@ definitions are explicitly removed.
 .Xr open 2 ,
 .Xr read 2 ,
 .Xr write 2
-.Sh BUGS
-The standard buffered functions do not interact well with certain other
-library and system functions, especially
-.Xr vfork 2 .
 .Sh STANDARDS
 The
 .Nm
@@ -296,3 +292,7 @@ library conforms to
 .It "vsprintf  formatted output conversion"
 .It "vsscanf   input format conversion"
 .El
+.Sh BUGS
+The standard buffered functions do not interact well with certain other
+library and system functions, especially
+.Xr vfork 2 .
index 75a5507..57b4495 100644 (file)
@@ -35,7 +35,7 @@
 .\"
 .\"     @(#)getenv.3   8.2 (Berkeley) 12/11/93
 .\" $FreeBSD: src/lib/libc/stdlib/getenv.3,v 1.4.2.7 2001/12/14 18:33:58 ru Exp $
-.\" $DragonFly: src/lib/libc/stdlib/getenv.3,v 1.4 2004/03/11 12:28:50 hmp Exp $
+.\" $DragonFly: src/lib/libc/stdlib/getenv.3,v 1.5 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd December 11, 1993
 .Dt GETENV 3
@@ -142,6 +142,17 @@ The
 .Fn getenv
 function conforms to
 .St -isoC .
+.Sh HISTORY
+The functions
+.Fn setenv
+and
+.Fn unsetenv
+appeared in
+.At v7 .
+The
+.Fn putenv
+function appeared in
+.Bx 4.3 Reno .
 .Sh BUGS
 Successive calls to
 .Fn setenv
@@ -159,14 +170,3 @@ semantics for these functions
 are copied and that old values remain accessible indefinitely) make this
 bug unavoidable.  Future versions may eliminate one or both of these
 semantic guarantees in order to fix the bug.
-.Sh HISTORY
-The functions
-.Fn setenv
-and
-.Fn unsetenv
-appeared in
-.At v7 .
-The
-.Fn putenv
-function appeared in
-.Bx 4.3 Reno .
index 3502866..4696484 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)getopt.3   8.5 (Berkeley) 4/27/95
 .\" $FreeBSD: src/lib/libc/stdlib/getopt.3,v 1.11.2.8 2001/12/14 18:33:58 ru Exp $
-.\" $DragonFly: src/lib/libc/stdlib/getopt.3,v 1.3 2005/09/23 19:56:32 swildner Exp $
+.\" $DragonFly: src/lib/libc/stdlib/getopt.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 27, 1995
 .Dt GETOPT 3
@@ -139,6 +139,27 @@ When all options have been processed (i.e., up to the first non-option
 argument),
 .Fn getopt
 returns \-1.
+.Sh EXAMPLES
+.Bd -literal -compact
+int bflag, ch, fd;
+
+bflag = 0;
+while ((ch = getopt(argc, argv, "bf:")) != -1) {
+       switch (ch) {
+       case 'b':
+               bflag = 1;
+               break;
+       case 'f':
+               if ((fd = open(optarg, O_RDONLY, 0)) < 0)
+                       err(1, "%s", optarg);
+               break;
+       default:
+               usage();
+       }
+}
+argc -= optind;
+argv += optind;
+.Ed
 .Sh DIAGNOSTICS
 If the
 .Fn getopt
@@ -173,27 +194,6 @@ function multiple times.
 This is an extension to the
 .St -p1003.2
 specification.
-.Sh EXAMPLES
-.Bd -literal -compact
-int bflag, ch, fd;
-
-bflag = 0;
-while ((ch = getopt(argc, argv, "bf:")) != -1) {
-       switch (ch) {
-       case 'b':
-               bflag = 1;
-               break;
-       case 'f':
-               if ((fd = open(optarg, O_RDONLY, 0)) < 0)
-                       err(1, "%s", optarg);
-               break;
-       default:
-               usage();
-       }
-}
-argc -= optind;
-argv += optind;
-.Ed
 .Sh HISTORY
 The
 .Fn getopt
index 8d3b5f7..eeae150 100644 (file)
@@ -1,5 +1,5 @@
 .\"    $NetBSD: getopt_long.3,v 1.14 2003/08/07 16:43:40 agc Exp $
-.\"    $DragonFly: src/lib/libc/stdlib/getopt_long.3,v 1.2 2005/03/13 20:13:41 joerg Exp $
+.\"    $DragonFly: src/lib/libc/stdlib/getopt_long.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .\" Copyright (c) 1988, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -139,47 +139,6 @@ and setting
 to the corresponding short option will make this function act just
 like
 .Xr getopt 3 .
-.Sh EXAMPLES
-.Bd -literal -compact
-extern char *optarg;
-extern int optind;
-int bflag, ch, fd;
-int daggerset;
-
-/* options descriptor */
-static struct option longopts[] = {
-       { "buffy",      no_argument,            0,              'b' },
-       { "floride",    required_argument,      0,              'f' },
-       { "daggerset",  no_argument,            \*[Am]daggerset,        1 },
-       { NULL,         0,                      NULL,           0 }
-};
-
-bflag = 0;
-while ((ch = getopt_long(argc, argv, "bf:", longopts, NULL)) != -1)
-       switch (ch) {
-       case 'b':
-               bflag = 1;
-               break;
-       case 'f':
-               if ((fd = open(optarg, O_RDONLY, 0)) \*[Lt] 0) {
-                       (void)fprintf(stderr,
-                           "myname: %s: %s\en", optarg, strerror(errno));
-                       exit(1);
-               }
-               break;
-       case 0:
-               if(daggerset) {
-                       fprintf(stderr,"Buffy will use her dagger to "
-                                      "apply floride to dracula's teeth\en");
-               }
-               break;
-       case '?':
-       default:
-               usage();
-}
-argc -= optind;
-argv += optind;
-.Ed
 .Sh IMPLEMENTATION DIFFERENCES
 This section describes differences to the GNU implementation
 found in glibc-2.1.3:
@@ -272,6 +231,47 @@ The aspects normally used by the caller
 to current positions) are the same, though.
 (We do fewer variable swaps.)
 .El
+.Sh EXAMPLES
+.Bd -literal -compact
+extern char *optarg;
+extern int optind;
+int bflag, ch, fd;
+int daggerset;
+
+/* options descriptor */
+static struct option longopts[] = {
+       { "buffy",      no_argument,            0,              'b' },
+       { "floride",    required_argument,      0,              'f' },
+       { "daggerset",  no_argument,            \*[Am]daggerset,        1 },
+       { NULL,         0,                      NULL,           0 }
+};
+
+bflag = 0;
+while ((ch = getopt_long(argc, argv, "bf:", longopts, NULL)) != -1)
+       switch (ch) {
+       case 'b':
+               bflag = 1;
+               break;
+       case 'f':
+               if ((fd = open(optarg, O_RDONLY, 0)) \*[Lt] 0) {
+                       (void)fprintf(stderr,
+                           "myname: %s: %s\en", optarg, strerror(errno));
+                       exit(1);
+               }
+               break;
+       case 0:
+               if(daggerset) {
+                       fprintf(stderr,"Buffy will use her dagger to "
+                                      "apply floride to dracula's teeth\en");
+               }
+               break;
+       case '?':
+       default:
+               usage();
+}
+argc -= optind;
+argv += optind;
+.Ed
 .Sh SEE ALSO
 .Xr getopt 3
 .Sh HISTORY
index 79778ae..5c250dc 100644 (file)
@@ -1,5 +1,5 @@
 .\" $FreeBSD: src/lib/libc/stdlib/hcreate.3,v 1.2.2.2 2003/04/05 13:53:05 dwmalone Exp $
-.\" $DragonFly: src/lib/libc/stdlib/hcreate.3,v 1.3 2005/08/05 22:35:10 swildner Exp $
+.\" $DragonFly: src/lib/libc/stdlib/hcreate.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd May 8, 2001
 .Os
@@ -136,16 +136,6 @@ could not be found or the
 is
 .Dv ENTER
 and the table is full.
-.Sh ERRORS
-The
-.Fn hcreate
-and
-.Fn hsearch
-functions may fail if:
-.Bl -tag -width Er
-.It Bq Er ENOMEM
-Insufficient storage space is available.
-.El
 .Sh EXAMPLES
 The following example reads in strings followed by two numbers
 and stores them in a hash table, discarding duplicates.
@@ -203,6 +193,16 @@ main(void)
        return 0;
 }
 .Ed
+.Sh ERRORS
+The
+.Fn hcreate
+and
+.Fn hsearch
+functions may fail if:
+.Bl -tag -width Er
+.It Bq Er ENOMEM
+Insufficient storage space is available.
+.El
 .Sh SEE ALSO
 .Xr bsearch 3 ,
 .Xr lsearch 3 ,
index fd2b8d0..b363990 100644 (file)
@@ -35,7 +35,7 @@
 .\"
 .\"     @(#)malloc.3   8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/stdlib/malloc.3,v 1.25.2.16 2003/01/06 17:10:45 trhodes Exp $
-.\" $DragonFly: src/lib/libc/stdlib/malloc.3,v 1.6 2006/02/12 21:19:07 dillon Exp $
+.\" $DragonFly: src/lib/libc/stdlib/malloc.3,v 1.7 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd August 27, 1996
 .Dt MALLOC 3
@@ -273,30 +273,6 @@ and
 options are intended for testing and debugging.
 An application which changes its behavior when these options are used
 is flawed.
-.Sh EXAMPLES
-To set a systemwide reduction of cache size, and to dump core whenever
-a problem occurs:
-.Pp
-.Bd -literal -offset indent
-ln -s 'A<' /etc/malloc.conf
-.Ed
-.Pp
-To specify in the source that a program does no return value checking
-on calls to these functions:
-.Bd -literal -offset indent
-extern char *malloc_options;
-malloc_options = "X";
-.Ed
-.Sh ENVIRONMENT
-The following environment variables affect the execution of the allocation
-functions:
-.Bl -tag -width ".Ev MALLOC_OPTIONS"
-.It Ev MALLOC_OPTIONS
-If the environment variable
-.Ev MALLOC_OPTIONS
-is set, the characters it contains will be interpreted as flags to the
-allocation functions.
-.El
 .Sh RETURN VALUES
 The
 .Fn malloc
@@ -334,6 +310,30 @@ deallocates it in this case.
 The
 .Fn free
 function returns no value.
+.Sh ENVIRONMENT
+The following environment variables affect the execution of the allocation
+functions:
+.Bl -tag -width ".Ev MALLOC_OPTIONS"
+.It Ev MALLOC_OPTIONS
+If the environment variable
+.Ev MALLOC_OPTIONS
+is set, the characters it contains will be interpreted as flags to the
+allocation functions.
+.El
+.Sh EXAMPLES
+To set a systemwide reduction of cache size, and to dump core whenever
+a problem occurs:
+.Pp
+.Bd -literal -offset indent
+ln -s 'A<' /etc/malloc.conf
+.Ed
+.Pp
+To specify in the source that a program does no return value checking
+on calls to these functions:
+.Bd -literal -offset indent
+extern char *malloc_options;
+malloc_options = "X";
+.Ed
 .Sh DEBUGGING MALLOC PROBLEMS
 The major difference between this implementation and other allocation
 implementations is that the free pages are not accessed unless allocated,
index 56da6a7..a0c143f 100644 (file)
@@ -35,7 +35,7 @@
 .\"
 .\"     @(#)qsort.3    8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/stdlib/qsort.3,v 1.4.2.5 2001/12/14 18:33:58 ru Exp $
-.\" $DragonFly: src/lib/libc/stdlib/qsort.3,v 1.3 2005/08/05 22:35:10 swildner Exp $
+.\" $DragonFly: src/lib/libc/stdlib/qsort.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt QSORT 3
@@ -158,6 +158,12 @@ function
 returns no value.
 .Pp
 .Rv -std heapsort mergesort
+.Sh COMPATIBILITY
+Previous versions of
+.Fn qsort
+did not permit the comparison routine itself to call
+.Fn qsort 3 .
+This is no longer true.
 .Sh ERRORS
 The
 .Fn heapsort
@@ -181,12 +187,6 @@ or
 .Fn mergesort
 were unable to allocate memory.
 .El
-.Sh COMPATIBILITY
-Previous versions of
-.Fn qsort
-did not permit the comparison routine itself to call
-.Fn qsort 3 .
-This is no longer true.
 .Sh SEE ALSO
 .Xr sort 1 ,
 .Xr radixsort 3
index 63d1253..556cfef 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)random.3   8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/stdlib/random.3,v 1.11.2.6 2003/06/03 19:13:16 schweikh Exp $
-.\" $DragonFly: src/lib/libc/stdlib/random.3,v 1.2 2003/06/17 04:26:46 dillon Exp $
+.\" $DragonFly: src/lib/libc/stdlib/random.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt RANDOM 3
@@ -165,6 +165,14 @@ generator is greater than
 .if t 2\u\s769\s10\d,
 .if n 2**69
 which should be sufficient for most purposes.
+.Sh SEE ALSO
+.Xr rand 3 ,
+.Xr srand 3 ,
+.Xr urandom 4
+.Sh HISTORY
+These
+functions appeared in
+.Bx 4.2 .
 .Sh AUTHORS
 .An Earl T. Cohen
 .Sh DIAGNOSTICS
@@ -174,14 +182,6 @@ is called with less than 8 bytes of state information, or if
 .Fn setstate
 detects that the state information has been garbled, error
 messages are printed on the standard error output.
-.Sh SEE ALSO
-.Xr rand 3 ,
-.Xr srand 3 ,
-.Xr urandom 4
-.Sh HISTORY
-These
-functions appeared in
-.Bx 4.2 .
 .Sh BUGS
 About 2/3 the speed of
 .Xr rand 3 .
index d74b3af..1c88bd1 100644 (file)
@@ -26,7 +26,7 @@
 .\"
 .\"    OpenBSD: tsearch.3,v 1.2 1998/06/21 22:13:49 millert Exp
 .\" $FreeBSD: src/lib/libc/stdlib/tsearch.3,v 1.1.2.6 2001/12/14 18:33:58 ru Exp $
-.\" $DragonFly: src/lib/libc/stdlib/tsearch.3,v 1.3 2005/08/05 22:35:10 swildner Exp $
+.\" $DragonFly: src/lib/libc/stdlib/tsearch.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 15, 1997
 .Dt TSEARCH 3
@@ -99,10 +99,6 @@ a value from the enum
 .Sy "typedef enum { preorder, postorder, endorder, leaf } VISIT;"
 specifying the traversal type, and a node level (where level
 zero is the root of the tree).
-.Sh SEE ALSO
-.Xr bsearch 3 ,
-.Xr hsearch 3 ,
-.Xr lsearch 3
 .Sh RETURN VALUES
 The
 .Fn tsearch
@@ -120,3 +116,7 @@ is NULL or the datum cannot be found.
 The
 .Fn twalk
 function returns no value.
+.Sh SEE ALSO
+.Xr bsearch 3 ,
+.Xr hsearch 3 ,
+.Xr lsearch 3
index e35510e..c77001e 100644 (file)
@@ -24,7 +24,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/stdtime/strptime.3,v 1.9.2.9 2003/05/24 00:01:31 keramida Exp $
-.\" $DragonFly: src/lib/libc/stdtime/strptime.3,v 1.2 2003/06/17 04:26:46 dillon Exp $
+.\" $DragonFly: src/lib/libc/stdtime/strptime.3,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\" "
 .Dd January 4, 2003
 .Dt STRPTIME 3
@@ -109,6 +109,11 @@ if one of the conversions failed.
 .Xr date 1 ,
 .Xr scanf 3 ,
 .Xr strftime 3
+.Sh HISTORY
+The
+.Fn strptime
+function appeared in
+.Fx 3.0 .
 .Sh AUTHORS
 The
 .Fn strptime
@@ -116,11 +121,6 @@ function has been contributed by Powerdog Industries.
 .Pp
 This man page was written by
 .An J\(:org Wunsch .
-.Sh HISTORY
-The
-.Fn strptime
-function appeared in
-.Fx 3.0 .
 .Sh BUGS
 Both the
 .Fa %e
index 4fcf6e0..55ec4c9 100644 (file)
@@ -49,7 +49,7 @@
 .\"
 .\"     @(#)strtok.3   8.2 (Berkeley) 2/3/94
 .\" $FreeBSD: src/lib/libc/string/strtok.3,v 1.10.2.8 2001/12/14 18:33:59 ru Exp $
-.\" $DragonFly: src/lib/libc/string/strtok.3,v 1.3 2005/08/05 22:35:10 swildner Exp $
+.\" $DragonFly: src/lib/libc/string/strtok.3,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd November 27, 1998
 .Dt STRTOK 3
@@ -154,6 +154,14 @@ The
 function
 conforms to
 .St -isoC .
+.Sh AUTHORS
+.An Wes Peters ,
+Softweyr LLC:
+.Aq wes@softweyr.com
+.Pp
+Based on the
+.Fx 3.0
+implementation.
 .Sh BUGS
 The System V
 .Fn strtok ,
@@ -167,11 +175,3 @@ value.
 Since this implementation always alters the next starting point,
 such a sequence of calls would always return
 .Dv NULL .
-.Sh AUTHORS
-.An Wes Peters ,
-Softweyr LLC:
-.Aq wes@softweyr.com
-.Pp
-Based on the
-.Fx 3.0
-implementation.
index eb9a4bf..b285319 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_cancel.2,v 1.5.2.6 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_cancel.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/aio_cancel.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd January 19, 2000
 .Dt AIO_CANCEL 2
@@ -73,12 +73,6 @@ checked with
 .It Bq Dv AIO_ALLDONE
 All of the requests meeting the criteria have finished.
 .El
-.Sh SEE ALSO
-.Xr aio_error 2 ,
-.Xr aio_read 2 ,
-.Xr aio_return 2 ,
-.Xr aio_suspend 2 ,
-.Xr aio_write 2
 .Sh ERRORS
 An error return from
 .Fn aio_cancel
@@ -88,6 +82,12 @@ indicates:
 .Fa fildes
 is an invalid file descriptor.
 .El
+.Sh SEE ALSO
+.Xr aio_error 2 ,
+.Xr aio_read 2 ,
+.Xr aio_return 2 ,
+.Xr aio_suspend 2 ,
+.Xr aio_write 2
 .Sh STANDARDS
 The
 .Fn aio_cancel
index 55ef992..73712ed 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_return.2,v 1.5.2.6 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_return.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/aio_return.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 2, 1999
 .Dt AIO_RETURN 2
@@ -64,15 +64,6 @@ returns
 and sets
 .Dv errno
 to indicate the error condition.
-.Sh SEE ALSO
-.Xr aio_cancel 2 ,
-.Xr aio_error 2 ,
-.Xr aio_read 2 ,
-.Xr aio_suspend 2 ,
-.Xr aio_write 2 ,
-.Xr fsync 2 ,
-.Xr read 2 ,
-.Xr write 2
 .Sh ERRORS
 The
 .Fn aio_return
@@ -82,6 +73,15 @@ function will fail if:
 .Fa iocb
 does not reference an outstanding asynchronous I/O request.
 .El
+.Sh SEE ALSO
+.Xr aio_cancel 2 ,
+.Xr aio_error 2 ,
+.Xr aio_read 2 ,
+.Xr aio_suspend 2 ,
+.Xr aio_write 2 ,
+.Xr fsync 2 ,
+.Xr read 2 ,
+.Xr write 2
 .Sh STANDARDS
 .Fn aio_return
 is expected to conform to the
index 81dfd67..b896f39 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_suspend.2,v 1.8.2.5 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_suspend.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/aio_suspend.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 2, 1999
 .Dt AIO_SUSPEND 2
@@ -68,12 +68,6 @@ completed,
 returns 0.  Otherwise it returns -1 and sets
 .Va errno
 to indicate the error, as enumerated below.
-.Sh SEE ALSO
-.Xr aio_cancel 2 ,
-.Xr aio_error 2 ,
-.Xr aio_read 2 ,
-.Xr aio_suspend 2 ,
-.Xr aio_write 2
 .Sh ERRORS
 The
 .Fn aio_suspend
@@ -92,6 +86,12 @@ valid.
 .It Bq Er EINTR
 the suspend was interrupted by a signal.
 .El
+.Sh SEE ALSO
+.Xr aio_cancel 2 ,
+.Xr aio_error 2 ,
+.Xr aio_read 2 ,
+.Xr aio_suspend 2 ,
+.Xr aio_write 2
 .Sh STANDARDS
 .Fn aio_suspend
 is expected to conform to the
index 768e0e9..cbc76d0 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)brk.2      8.4 (Berkeley) 5/1/95
 .\" $FreeBSD: src/lib/libc/sys/brk.2,v 1.13.2.10 2002/03/04 12:00:31 dwmalone Exp $
-.\" $DragonFly: src/lib/libc/sys/brk.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/brk.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd July 12, 1999
 .Dt BRK 2
@@ -151,6 +151,11 @@ to support the expansion of the data segment.
 .Xr end 3 ,
 .Xr free 3 ,
 .Xr malloc 3
+.Sh HISTORY
+A
+.Fn brk
+function call appeared in
+.At v7 .
 .Sh BUGS
 Mixing
 .Fn brk
@@ -167,8 +172,3 @@ It is not possible to distinguish this
 from a failure caused by exceeding the maximum size of
 the data segment without consulting
 .Xr getrlimit 2 .
-.Sh HISTORY
-A
-.Fn brk
-function call appeared in
-.At v7 .
index 6f1ba20..938631c 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"    @(#)getlogin.2  8.1 (Berkeley) 6/9/93
 .\" $FreeBSD: src/lib/libc/sys/getlogin.2,v 1.14.2.6 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/getlogin.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/getlogin.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 9, 1993
 .Dt GETLOGIN 2
@@ -167,17 +167,12 @@ The size of the buffer is smaller than the result to be returned.
 .Sh SEE ALSO
 .Xr setsid 2 ,
 .Xr daemon 3
-.Sh BUGS
-In earlier versions of the system,
-.Fn getlogin
-failed unless the process was associated with a login terminal.
-The current implementation (using
-.Fn setlogin )
-allows getlogin to succeed even when the process has no controlling terminal.
-In earlier versions of the system, the value returned by
+.Sh STANDARDS
 .Fn getlogin
-could not be trusted without checking the user ID.
-Portable programs should probably still make this check.
+and
+.Fn getlogin_r
+conform to
+.St -p1003.1-96 .
 .Sh HISTORY
 The
 .Fn getlogin
@@ -189,9 +184,14 @@ was changed from earlier versions of
 .Fx
 to be conformant with
 .St -p1003.1-96 .
-.Sh STANDARDS
+.Sh BUGS
+In earlier versions of the system,
 .Fn getlogin
-and
-.Fn getlogin_r
-conform to
-.St -p1003.1-96 .
+failed unless the process was associated with a login terminal.
+The current implementation (using
+.Fn setlogin )
+allows getlogin to succeed even when the process has no controlling terminal.
+In earlier versions of the system, the value returned by
+.Fn getlogin
+could not be trusted without checking the user ID.
+Portable programs should probably still make this check.
index 5233e49..08909fd 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)getpgrp.2  8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/getpgrp.2,v 1.11.2.6 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/getpgrp.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/getpgrp.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt GETPGRP 2
@@ -87,31 +87,6 @@ call returns the process group of the specified process;
 otherwise, it returns a value of \-1 and sets
 .Va errno
 to indicate the error.
-.Sh ERRORS
-.Fn getpgid
-will succeed unless:
-.Bl -tag -width Er
-.It Bq Er ESRCH
-there is no process whose process ID equals
-.Fa pid
-.El
-.Sh SEE ALSO
-.Xr getsid 2 ,
-.Xr setpgid 2 ,
-.Xr termios 4
-.Sh HISTORY
-The
-.Fn getpgrp
-function call appeared in
-.Bx 4.0 .
-The
-.Fn getpgid
-function call is derived from its usage in System V Release 4.
-.Sh STANDARDS
-The
-.Fn getpgrp
-function call is expected to conform to
-.St -p1003.1-90 .
 .Sh COMPATIBILITY
 This version of
 .Fn getpgrp
@@ -142,3 +117,28 @@ has been omitted from POSIX.1.
 The old functionality is available from the
 .Fn getpgid
 function.
+.Sh ERRORS
+.Fn getpgid
+will succeed unless:
+.Bl -tag -width Er
+.It Bq Er ESRCH
+there is no process whose process ID equals
+.Fa pid
+.El
+.Sh SEE ALSO
+.Xr getsid 2 ,
+.Xr setpgid 2 ,
+.Xr termios 4
+.Sh STANDARDS
+The
+.Fn getpgrp
+function call is expected to conform to
+.St -p1003.1-90 .
+.Sh HISTORY
+The
+.Fn getpgrp
+function call appeared in
+.Bx 4.0 .
+The
+.Fn getpgid
+function call is derived from its usage in System V Release 4.
index 5f78322..0f0a623 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)getrusage.2        8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/getrusage.2,v 1.10.2.5 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/getrusage.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/getrusage.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt GETRUSAGE 2
@@ -172,11 +172,11 @@ parameter is not in a valid part of the process address space.
 .Xr gettimeofday 2 ,
 .Xr wait 2 ,
 .Xr clocks 7
-.Sh BUGS
-There is no way to obtain information about a child process
-that has not yet terminated.
 .Sh HISTORY
 The
 .Fn getrusage
 function call appeared in
 .Bx 4.2 .
+.Sh BUGS
+There is no way to obtain information about a child process
+that has not yet terminated.
index 66c5ba1..48c52f0 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)getsockname.2      8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/getsockname.2,v 1.9.2.8 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/getsockname.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/getsockname.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt GETSOCKNAME 2
@@ -85,12 +85,12 @@ process address space.
 .Xr bind 2 ,
 .Xr getpeername 2 ,
 .Xr socket 2
-.Sh BUGS
-Names bound to sockets in the UNIX domain are inaccessible;
-.Xr getsockname
-returns a zero length name.
 .Sh HISTORY
 The
 .Fn getsockname
 function call appeared in
 .Bx 4.2 .
+.Sh BUGS
+Names bound to sockets in the UNIX domain are inaccessible;
+.Xr getsockname
+returns a zero length name.
index 657593a..77eb7e6 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)getsockopt.2       8.4 (Berkeley) 5/2/95
 .\" $FreeBSD: src/lib/libc/sys/getsockopt.2,v 1.12.2.11 2002/01/09 17:44:15 yar Exp $
-.\" $DragonFly: src/lib/libc/sys/getsockopt.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/getsockopt.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd May 2, 1995
 .Dt GETSOCKOPT 2
@@ -393,10 +393,10 @@ on a non-listening socket was attempted.
 .Xr protocols 5 ,
 .Xr sysctl 8 ,
 .Xr accept_filter 9
-.Sh BUGS
-Several of the socket options should be handled at lower levels of the system.
 .Sh HISTORY
 The
 .Fn getsockopt
 system call appeared in
 .Bx 4.2 .
+.Sh BUGS
+Several of the socket options should be handled at lower levels of the system.
index fa6a64f..122b0a3 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)lseek.2    8.3 (Berkeley) 4/19/94
 .\" $FreeBSD: src/lib/libc/sys/lseek.2,v 1.10.2.6 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/lseek.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/lseek.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 19, 1994
 .Dt LSEEK 2
@@ -129,10 +129,6 @@ is not a proper value.
 .Sh SEE ALSO
 .Xr dup 2 ,
 .Xr open 2
-.Sh BUGS
-This document's use of
-.Fa whence
-is incorrect English, but is maintained for historical reasons.
 .Sh STANDARDS
 The
 .Fn lseek
@@ -143,3 +139,7 @@ A
 .Fn lseek
 function call appeared in
 .At v7 .
+.Sh BUGS
+This document's use of
+.Fa whence
+is incorrect English, but is maintained for historical reasons.
index b8bbfa6..db400b5 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"    @(#)mlock.2     8.2 (Berkeley) 12/11/93
 .\" $FreeBSD: src/lib/libc/sys/mlock.2,v 1.6.2.5 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/mlock.2,v 1.3 2004/05/20 20:54:50 hmp Exp $
+.\" $DragonFly: src/lib/libc/sys/mlock.2,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd May 18, 2004
 .Dt MLOCK 2
@@ -145,6 +145,13 @@ Some portion of the indicated address range is not locked.
 .Xr munmap 2 ,
 .Xr setrlimit 2 ,
 .Xr getpagesize 3
+.Sh HISTORY
+The
+.Fn mlock
+and
+.Fn munlock
+functions first appeared in
+.Bx 4.4 .
 .Sh BUGS
 The per-process resource limit is a limit on the amount of virtual
 memory locked, while the system-wide limit is for the number of locked
@@ -154,10 +161,3 @@ counts as 2 pages against the per-process limit and as only a single page
 in the system limit.
 .Pp
 The per-process resource limit is not currently supported.
-.Sh HISTORY
-The
-.Fn mlock
-and
-.Fn munlock
-functions first appeared in
-.Bx 4.4 .
index 6b34c15..1237e62 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)mount.2    8.3 (Berkeley) 5/24/95
 .\" $FreeBSD: src/lib/libc/sys/mount.2,v 1.20.2.8 2003/01/17 22:02:42 joerg Exp $
-.\" $DragonFly: src/lib/libc/sys/mount.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/mount.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd May 24, 1995
 .Dt MOUNT 2
@@ -318,11 +318,11 @@ mounted.
 .Xr mount 8 ,
 .Xr sysctl 8 ,
 .Xr umount 8
-.Sh BUGS
-Some of the error codes need translation to more obvious messages.
 .Sh HISTORY
 .Fn Mount
 and
 .Fn unmount
 function calls appeared in
 .At v6 .
+.Sh BUGS
+Some of the error codes need translation to more obvious messages.
index bd76e4d..69f779a 100644 (file)
@@ -1,6 +1,6 @@
 .\"    $NetBSD: poll.2,v 1.3 1996/09/07 21:53:08 mycroft Exp $
 .\" $FreeBSD: src/lib/libc/sys/poll.2,v 1.4.2.3 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/poll.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/poll.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .\" Copyright (c) 1996 Charles M. Hannum.  All rights reserved.
 .\"
@@ -177,13 +177,6 @@ The specified time limit is negative.
 .Xr select 2 ,
 .Xr send 2 ,
 .Xr write 2
-.Sh BUGS
-The distinction between some of the fields in the
-.Fa events
-and
-.Fa revents
-bitmasks is really not useful without STREAMS.  The fields are
-defined for compatibility with existing software.
 .Sh HISTORY
 The
 .Fn poll
@@ -191,3 +184,10 @@ function call appeared in
 .At V .
 This manual page and the core of the implementation was taken from
 .Nx .
+.Sh BUGS
+The distinction between some of the fields in the
+.Fa events
+and
+.Fa revents
+bitmasks is really not useful without STREAMS.  The fields are
+defined for compatibility with existing software.
index e4e5934..1f1215a 100644 (file)
@@ -34,7 +34,7 @@
 .\"
 .\"    @(#)quotactl.2  8.2 (Berkeley) 3/10/95
 .\" $FreeBSD: src/lib/libc/sys/quotactl.2,v 1.12.2.7 2002/05/20 09:06:37 roam Exp $
-.\" $DragonFly: src/lib/libc/sys/quotactl.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/quotactl.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd March 5, 1999
 .Dt QUOTACTL 2
@@ -214,14 +214,14 @@ The call was privileged and the caller was not the super-user.
 .Xr quotacheck 8 ,
 .Xr quotaon 8 ,
 .Xr repquota 8
+.Sh HISTORY
+The
+.Fn quotactl
+function call appeared in
+.Bx 4.3 Reno .
 .Sh BUGS
 There should be some way to integrate this call with the resource
 limit interface provided by
 .Xr setrlimit 2
 and
 .Xr getrlimit 2 .
-.Sh HISTORY
-The
-.Fn quotactl
-function call appeared in
-.Bx 4.3 Reno .
index d2b51e0..e7195ab 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)reboot.2   8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/reboot.2,v 1.9.2.4 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/reboot.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/reboot.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt REBOOT 2
@@ -155,13 +155,13 @@ The caller is not the super-user.
 .Xr init 8 ,
 .Xr reboot 8 ,
 .Xr savecore 8
-.Sh BUGS
-The HP300 implementation supports neither
-.Dv RB_DFLTROOT
-nor
-.Dv RB_KDB .
 .Sh HISTORY
 The
 .Fn reboot
 function call appeared in
 .Bx 4.0 .
+.Sh BUGS
+The HP300 implementation supports neither
+.Dv RB_DFLTROOT
+nor
+.Dv RB_KDB .
index 895b18e..2db51ff 100644 (file)
@@ -4,7 +4,7 @@
 .\" use of this page comes from Rob Pike <rob@plan9.att.com>.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/rfork.2,v 1.11.2.11 2002/07/30 19:04:25 silby Exp $
-.\" $DragonFly: src/lib/libc/sys/rfork.2,v 1.3 2004/03/11 12:28:51 hmp Exp $
+.\" $DragonFly: src/lib/libc/sys/rfork.2,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd January 12, 1996
 .Dt RFORK 2
@@ -152,6 +152,10 @@ There is insufficient swap space for the new process.
 .Xr minherit 2 ,
 .Xr vfork 2 ,
 .Xr rfork_thread 3
+.Sh HISTORY
+The
+.Fn rfork
+function call first appeared in Plan9.
 .Sh BUGS
 .Dx
 does not yet implement a native
@@ -167,7 +171,3 @@ The
 .Fn rfork_thread
 library call can often be used instead of
 .Fn clone .
-.Sh HISTORY
-The
-.Fn rfork
-function call first appeared in Plan9.
index 63a747d..75bc973 100644 (file)
@@ -28,7 +28,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/rtprio.2,v 1.13.2.9 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/rtprio.2,v 1.3 2004/03/11 12:28:51 hmp Exp $
+.\" $DragonFly: src/lib/libc/sys/rtprio.2,v 1.4 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd July 23, 1994
 .Dt RTPRIO 2
@@ -100,12 +100,6 @@ may only change the idle priority of the current process.
 .It Bq Er ESRCH
 The specified process was not found.
 .El
-.Sh AUTHORS
-.An -nosplit
-The original author was
-.An Henrik Vestergaard Draboel Aq hvd@terry.ping.dk .
-This implementation was substantially rewritten by
-.An David Greenman .
 .Sh SEE ALSO
 .Xr nice 1 ,
 .Xr ps 1 ,
@@ -113,3 +107,9 @@ This implementation was substantially rewritten by
 .Xr setpriority 2 ,
 .Xr nice 3 ,
 .Xr renice 8
+.Sh AUTHORS
+.An -nosplit
+The original author was
+.An Henrik Vestergaard Draboel Aq hvd@terry.ping.dk .
+This implementation was substantially rewritten by
+.An David Greenman .
index 794d2fb..72a0fe4 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)select.2   8.2 (Berkeley) 3/25/94
 .\" $FreeBSD: src/lib/libc/sys/select.2,v 1.14.2.5 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/select.2,v 1.5 2005/08/03 16:07:39 corecode Exp $
+.\" $DragonFly: src/lib/libc/sys/select.2,v 1.6 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd March 25, 1994
 .Dt SELECT 2
@@ -193,6 +193,11 @@ is not guaranteed to examine the unused file descriptors.   For historical
 reasons,
 .Fn select
 will always examine the first 256 descriptors.
+.Sh HISTORY
+The
+.Fn select
+function call appeared in
+.Bx 4.2 .
 .Sh BUGS
 .St -susv2
 allows systems to modify the original timeout in place.
@@ -200,8 +205,3 @@ Thus, it is unwise to assume that the timeout value will be unmodified
 by the
 .Fn select
 call.
-.Sh HISTORY
-The
-.Fn select
-function call appeared in
-.Bx 4.2 .
index 8e92ba0..ca86036 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     From: @(#)send.2       8.2 (Berkeley) 2/21/94
 .\" $FreeBSD: src/lib/libc/sys/send.2,v 1.10.2.6 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/send.2,v 1.6 2005/04/02 16:22:41 liamfoy Exp $
+.\" $DragonFly: src/lib/libc/sys/send.2,v 1.7 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd February 15, 1995
 .Dt SEND 2
@@ -193,6 +193,18 @@ The socket is unable to send anymore data (SS_CANTSENDMORE has
 been set on the socket). This typically means that the socket
 is not connected.
 .El
+.Sh SEE ALSO
+.Xr fcntl 2 ,
+.Xr getsockopt 2 ,
+.Xr recv 2 ,
+.Xr select 2 ,
+.Xr socket 2 ,
+.Xr write 2
+.Sh HISTORY
+The
+.Fn send
+function call appeared in
+.Bx 4.2 .
 .Sh BUGS
 Because
 .Fn sendmsg
@@ -207,15 +219,3 @@ then
 it before it has actually been sent, the result being that the receiver
 gets a closed file descriptor.  It is left to the application to
 implement an acknowlegment mechanism to prevent this from happening.
-.Sh SEE ALSO
-.Xr fcntl 2 ,
-.Xr getsockopt 2 ,
-.Xr recv 2 ,
-.Xr select 2 ,
-.Xr socket 2 ,
-.Xr write 2
-.Sh HISTORY
-The
-.Fn send
-function call appeared in
-.Bx 4.2 .
index 15faa55..fee35d6 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)setpgid.2  8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/setpgid.2,v 1.5.2.7 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/setpgid.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/setpgid.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt SETPGID 2
@@ -63,6 +63,13 @@ must have the same effective user-id as the invoker or be a descendant
 of the invoking process.
 .Sh RETURN VALUES
 .Rv -std setpgid
+.Sh COMPATIBILITY
+.Fn Setpgrp
+is identical to
+.Fn setpgid ,
+and is retained for calling convention compatibility with historical
+versions of
+.Bx .
 .Sh ERRORS
 .Fn Setpgid
 will fail and the process group will not be altered if:
@@ -81,10 +88,3 @@ The
 .Fn setpgid
 function call is expected to conform to
 .St -p1003.1-90 .
-.Sh COMPATIBILITY
-.Fn Setpgrp
-is identical to
-.Fn setpgid ,
-and is retained for calling convention compatibility with historical
-versions of
-.Bx .
index 5c3868d..421d596 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"    From: @(#)sigaction.2   8.2 (Berkeley) 4/3/94
 .\" $FreeBSD: src/lib/libc/sys/sigaction.2,v 1.22.2.10 2002/12/29 16:35:34 schweikh Exp $
-.\" $DragonFly: src/lib/libc/sys/sigaction.2,v 1.4 2005/08/01 01:49:16 swildner Exp $
+.\" $DragonFly: src/lib/libc/sys/sigaction.2,v 1.5 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 3, 1994
 .Dt SIGACTION 2
@@ -530,6 +530,25 @@ An attempt is made to ignore or supply a handler for
 or
 .Dv SIGSTOP .
 .El
+.Sh SEE ALSO
+.Xr kill 1 ,
+.Xr kill 2 ,
+.Xr ptrace 2 ,
+.Xr sigaltstack 2 ,
+.Xr sigblock 2 ,
+.Xr sigpause 2 ,
+.Xr sigpending 2 ,
+.Xr sigprocmask 2 ,
+.Xr sigsetmask 2 ,
+.Xr sigsuspend 2 ,
+.Xr sigvec 2 ,
+.Xr wait 2 ,
+.Xr fpsetmask 3 ,
+.Xr setjmp 3 ,
+.Xr siginterrupt 3 ,
+.Xr sigsetops 3 ,
+.Xr ucontext 3 ,
+.Xr tty 4
 .Sh STANDARDS
 The
 .Fn sigaction
@@ -569,22 +588,3 @@ and
 .\" and
 .\" SA_SIGINFO
 flags are featuring options commonly found in other operating systems.
-.Sh SEE ALSO
-.Xr kill 1 ,
-.Xr kill 2 ,
-.Xr ptrace 2 ,
-.Xr sigaltstack 2 ,
-.Xr sigblock 2 ,
-.Xr sigpause 2 ,
-.Xr sigpending 2 ,
-.Xr sigprocmask 2 ,
-.Xr sigsetmask 2 ,
-.Xr sigsuspend 2 ,
-.Xr sigvec 2 ,
-.Xr wait 2 ,
-.Xr fpsetmask 3 ,
-.Xr setjmp 3 ,
-.Xr siginterrupt 3 ,
-.Xr sigsetops 3 ,
-.Xr ucontext 3 ,
-.Xr tty 4
index 23510ec..60017e8 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)socketpair.2       8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/socketpair.2,v 1.6.2.6 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/socketpair.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/socketpair.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt SOCKETPAIR 2
@@ -85,12 +85,12 @@ process address space.
 .Xr pipe 2 ,
 .Xr read 2 ,
 .Xr write 2
-.Sh BUGS
-This call is currently implemented only for the
-.Tn UNIX
-domain.
 .Sh HISTORY
 The
 .Fn socketpair
 function call appeared in
 .Bx 4.2 .
+.Sh BUGS
+This call is currently implemented only for the
+.Tn UNIX
+domain.
index 8299a94..2ba7d59 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)stat.2     8.4 (Berkeley) 5/1/95
 .\" $FreeBSD: src/lib/libc/sys/stat.2,v 1.16.2.7 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/stat.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/stat.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd May 1, 1995
 .Dt STAT 2
@@ -257,13 +257,6 @@ An I/O error occurred while reading from or writing to the file system.
 .Xr chown 2 ,
 .Xr utimes 2 ,
 .Xr symlink 7
-.Sh BUGS
-Applying
-.Fn fstat
-to a socket (and thus to a pipe)
-returns a zeroed buffer,
-except for the blocksize field,
-and a unique device and inode number.
 .Sh STANDARDS
 The
 .Fn stat
@@ -282,3 +275,10 @@ A
 .Fn lstat
 function call appeared in
 .Bx 4.2 .
+.Sh BUGS
+Applying
+.Fn fstat
+to a socket (and thus to a pipe)
+returns a zeroed buffer,
+except for the blocksize field,
+and a unique device and inode number.
index 9b8194e..6f06a60 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)swapon.2   8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/swapon.2,v 1.6.2.6 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/swapon.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/swapon.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt SWAPON 2
@@ -104,13 +104,13 @@ points outside the process's allocated address space.
 .Sh SEE ALSO
 .Xr config 8 ,
 .Xr swapon 8
-.Sh BUGS
-There is no way to stop swapping on a disk so that the pack may be
-dismounted.
-.Pp
-This call will be upgraded in future versions of the system.
 .Sh HISTORY
 The
 .Fn swapon
 function call appeared in
 .Bx 4.0 .
+.Sh BUGS
+There is no way to stop swapping on a disk so that the pack may be
+dismounted.
+.Pp
+This call will be upgraded in future versions of the system.
index 72098e2..5b3ead4 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)sync.2     8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/sync.2,v 1.6.2.6 2001/12/14 18:34:01 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/sync.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/sync.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt SYNC 2
@@ -69,11 +69,11 @@ attributes.
 .Xr fsync 2 ,
 .Xr syncer 4 ,
 .Xr sync 8
-.Sh BUGS
-.Fn Sync
-may return before the buffers are completely flushed.
 .Sh HISTORY
 A
 .Fn sync
 function call appeared in
 .At v6 .
+.Sh BUGS
+.Fn Sync
+may return before the buffers are completely flushed.
index b87605d..e03fe36 100644 (file)
@@ -30,7 +30,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $DragonFly: src/lib/libc/sys/sys_checkpoint.2,v 1.4 2005/12/10 00:22:28 swildner Exp $
+.\" $DragonFly: src/lib/libc/sys/sys_checkpoint.2,v 1.5 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd November 22, 2004
 .Dt SYS_CHECKPOINT 2
@@ -104,78 +104,6 @@ being resumed typically returns a positive value; otherwise the value -1
 is returned and the global variable
 .Li errno
 is set to indicate the error.
-.Sh ERRORS
-.Bl -tag -width Er
-.It Bq Er EBADF
-The given
-.Fa fd
-is not a valid regular file, socket descriptor, or pipe.  Note that not
-all systems necessarily support checkpointing to sockets and pipes.
-.It Bq Er EPERM
-The caller does not have permission to issue the checkpoint command.
-Checkpointing may be restricted or disabled using sysctls.
-.It Bq Er EIO
-An I/O error occurred while reading from the file system.
-.It Bq Er EINVAL
-An invalid parameter was specified.
-.El
-.Sh CHECKPOINT FEATURES
-The system checkpointing code will save the process register state (including
-floating point registers), signal state, file descriptors representing
-regular files or directories (anything that can be converted into a file
-handle for storage), and both shared and private memory mappings.
-Private, writable mappings are copied to the checkpoint file while shared
-mappings and stored by referencing the file handle and offset.
-Note that the system checkpointing code does not retain references to
-deleted files, so mappings and open descriptors of deleted files
-cannot be restored.
-Unpredictable operation will occur if a checkpoint-unaware program
-is restored and some of the underlying files mapped by the program
-have changed.
-.Pp
-The system checkpointing code is not able to retain the process pid, process
-group, user/group creds, or descriptors 0, 1, and 2.  These will be inherited
-from whomever restores the checkpoint.
-.Pp
-When a checkpointed program is restored modified private mappings will
-be mapped from the checkpoint file itself, but major portions of the
-original program binary will be mapped from the original program binary.
-If the resumed program is checkpointed again the system will automatically
-copy any mappings from the original checkpoint file to the new one, since
-the original is likely being replaced.
-The caller must not truncate the existing checkpoint file when creating
-a new one or specify the existing file's file descriptor as the new
-one as this will destroy the data that the checkpoint operation needs
-to copy to the new file.
-.Sh SECURITY
-The sysctl
-.Em kern.ckptgroup
-controls which group can use system checkpointing.
-By default, only users in the
-.Ql wheel
-group are allowed to checkpoint and restore processes.
-To allow users in any group to have this capability (risky), set sysctl
-.Em kern.ckptgroup
-to -1.
-.Sh SIGNALS
-Two signals are associated with checkpointing.
-.Dv SIGCKPT
-is delivered via the tty ckpt character, usually control-E.  Its default
-action is to checkpoint a program and continue running it.  The
-.Dv SIGCKPTEXIT
-signal can only be delivered by
-.Xr kill 2 .
-Its default action is to checkpoint a program and then exit.
-.Dv SIGCKPTEXIT
-might not be implemented by the system.  Both signals are defined to
-be greater or equal to signal 32 and cannot be manipulated using legacy
-masking functions.
-.Pp
-If a program overrides the default action for a checkpoint signal the
-system will not undertake any action of its own.  The program may issue
-the checkpoint command from the signal handler itself or simply set a
-reminder for later action.  It is usually safest to set a reminder and
-do the actual checkpointing from your main loop.
 .Sh EXAMPLE
 .Bd -literal -offset indent -compact
 
@@ -250,6 +178,78 @@ docheckpoint(void)
     close(fd);
 }
 .Ed
+.Sh ERRORS
+.Bl -tag -width Er
+.It Bq Er EBADF
+The given
+.Fa fd
+is not a valid regular file, socket descriptor, or pipe.  Note that not
+all systems necessarily support checkpointing to sockets and pipes.
+.It Bq Er EPERM
+The caller does not have permission to issue the checkpoint command.
+Checkpointing may be restricted or disabled using sysctls.
+.It Bq Er EIO
+An I/O error occurred while reading from the file system.
+.It Bq Er EINVAL
+An invalid parameter was specified.
+.El
+.Sh CHECKPOINT FEATURES
+The system checkpointing code will save the process register state (including
+floating point registers), signal state, file descriptors representing
+regular files or directories (anything that can be converted into a file
+handle for storage), and both shared and private memory mappings.
+Private, writable mappings are copied to the checkpoint file while shared
+mappings and stored by referencing the file handle and offset.
+Note that the system checkpointing code does not retain references to
+deleted files, so mappings and open descriptors of deleted files
+cannot be restored.
+Unpredictable operation will occur if a checkpoint-unaware program
+is restored and some of the underlying files mapped by the program
+have changed.
+.Pp
+The system checkpointing code is not able to retain the process pid, process
+group, user/group creds, or descriptors 0, 1, and 2.  These will be inherited
+from whomever restores the checkpoint.
+.Pp
+When a checkpointed program is restored modified private mappings will
+be mapped from the checkpoint file itself, but major portions of the
+original program binary will be mapped from the original program binary.
+If the resumed program is checkpointed again the system will automatically
+copy any mappings from the original checkpoint file to the new one, since
+the original is likely being replaced.
+The caller must not truncate the existing checkpoint file when creating
+a new one or specify the existing file's file descriptor as the new
+one as this will destroy the data that the checkpoint operation needs
+to copy to the new file.
+.Sh SECURITY
+The sysctl
+.Em kern.ckptgroup
+controls which group can use system checkpointing.
+By default, only users in the
+.Ql wheel
+group are allowed to checkpoint and restore processes.
+To allow users in any group to have this capability (risky), set sysctl
+.Em kern.ckptgroup
+to -1.
+.Sh SIGNALS
+Two signals are associated with checkpointing.
+.Dv SIGCKPT
+is delivered via the tty ckpt character, usually control-E.  Its default
+action is to checkpoint a program and continue running it.  The
+.Dv SIGCKPTEXIT
+signal can only be delivered by
+.Xr kill 2 .
+Its default action is to checkpoint a program and then exit.
+.Dv SIGCKPTEXIT
+might not be implemented by the system.  Both signals are defined to
+be greater or equal to signal 32 and cannot be manipulated using legacy
+masking functions.
+.Pp
+If a program overrides the default action for a checkpoint signal the
+system will not undertake any action of its own.  The program may issue
+the checkpoint command from the signal handler itself or simply set a
+reminder for later action.  It is usually safest to set a reminder and
+do the actual checkpointing from your main loop.
 .Sh SEE ALSO
 .Xr checkpt 1 ,
 .Xr signal 3
index a4aeaac..ac7898b 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)syscall.2  8.1 (Berkeley) 6/16/93
 .\" $FreeBSD: src/lib/libc/sys/syscall.2,v 1.5.2.3 2001/12/14 18:34:02 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/syscall.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/syscall.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 16, 1993
 .Dt SYSCALL 2
@@ -69,12 +69,12 @@ In general, a 0 return value indicates success.
 A -1 return value indicates an error,
 and an error code is stored in
 .Va errno .
-.Sh BUGS
-There is no way to simulate system calls that have multiple return values
-such as
-.Xr pipe 2 .
 .Sh HISTORY
 The
 .Fn syscall
 function call appeared in
 .Bx 4.0 .
+.Sh BUGS
+There is no way to simulate system calls that have multiple return values
+such as
+.Xr pipe 2 .
index bf6d8dd..d77acab 100644 (file)
@@ -30,7 +30,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $DragonFly: src/lib/libc/sys/tls.2,v 1.5 2005/12/10 00:22:28 swildner Exp $
+.\" $DragonFly: src/lib/libc/sys/tls.2,v 1.6 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd February 21, 2005
 .Dt TLS 2
@@ -87,18 +87,6 @@ If the kernel is unable to accomodate the supplied base address an error
 will be returned.
 .Sh RETURN VALUES
 A return value of 0 is returned on success, -1 on error.
-.Sh ERRORS
-.Bl -tag -width Er
-.It Bq Er ERANGE
-The specified facility index,
-.Fa which ,
-is not supported.
-.It Bq Er EINVAL
-An invalid parameter has been specified.
-.It Bq Er ENOENT
-(sys_get_tls_area) The specified facility has not been initialized with
-.Fn sys_set_tls_area .
-.El
 .Sh EXAMPLE
 .Bd -literal -compact
 
@@ -159,6 +147,18 @@ getdata(int offset)
 }
 
 .Ed
+.Sh ERRORS
+.Bl -tag -width Er
+.It Bq Er ERANGE
+The specified facility index,
+.Fa which ,
+is not supported.
+.It Bq Er EINVAL
+An invalid parameter has been specified.
+.It Bq Er ENOENT
+(sys_get_tls_area) The specified facility has not been initialized with
+.Fn sys_set_tls_area .
+.El
 .Sh SEE ALSO
 .Xr umtx 2
 .Sh HISTORY
index 836df54..d9bf723 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)truncate.2 8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/truncate.2,v 1.7.2.6 2001/12/14 18:34:02 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/truncate.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/truncate.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt TRUNCATE 2
@@ -115,6 +115,11 @@ is not open for writing.
 .El
 .Sh SEE ALSO
 .Xr open 2
+.Sh HISTORY
+The
+.Fn truncate
+function call appeared in
+.Bx 4.2 .
 .Sh BUGS
 These calls should be generalized to allow ranges
 of bytes in a file to be discarded.
@@ -122,8 +127,3 @@ of bytes in a file to be discarded.
 Use of
 .Fn truncate
 to extend a file is not portable.
-.Sh HISTORY
-The
-.Fn truncate
-function call appeared in
-.Bx 4.2 .
index ef9e4e5..d38c1fe 100644 (file)
@@ -30,7 +30,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $DragonFly: src/lib/libc/sys/umtx.2,v 1.6 2005/12/10 00:22:28 swildner Exp $
+.\" $DragonFly: src/lib/libc/sys/umtx.2,v 1.7 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd February 21, 2005
 .Dt UMTX 2
@@ -97,22 +97,6 @@ as shown below.
 .Pp
 .Fn umtx_wakeup
 will generally return 0 unless the address is bad.
-.Sh ERRORS
-.Bl -tag -width Er
-.It Bq Er EBUSY
-The contents of
-.Fa *ptr
-did not match
-.Fa value
-.It Bq Er ETIMEDOUT
-The specified timeout occured.
-.It Bq Er EINTR
-The
-.Fn umtx_sleep
-call was interrupted by a signal.
-.It Bq Er EINVAL
-An invalid parameter (typically an invalid timeout) was specified.
-.El
 .Sh EXAMPLE
 .Bd -literal -compact
 
@@ -201,6 +185,22 @@ userland_rel_mutex(struct umtx *mtx)
     }
 }
 .Ed
+.Sh ERRORS
+.Bl -tag -width Er
+.It Bq Er EBUSY
+The contents of
+.Fa *ptr
+did not match
+.Fa value
+.It Bq Er ETIMEDOUT
+The specified timeout occured.
+.It Bq Er EINTR
+The
+.Fn umtx_sleep
+call was interrupted by a signal.
+.It Bq Er EINVAL
+An invalid parameter (typically an invalid timeout) was specified.
+.El
 .Sh SEE ALSO
 .Xr tls 2
 .Sh HISTORY
index a202973..d20b89e 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)vfork.2    8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/vfork.2,v 1.12.2.6 2002/12/29 16:35:34 schweikh Exp $
-.\" $DragonFly: src/lib/libc/sys/vfork.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/vfork.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt VFORK 2
@@ -92,6 +92,9 @@ parent processes standard I/O data structures.
 it is wrong to call
 .Xr exit 3
 since buffered data would then be flushed twice.)
+.Sh RETURN VALUES
+Same as for
+.Xr fork 2 .
 .Sh SEE ALSO
 .Xr execve 2 ,
 .Xr fork 2 ,
@@ -100,9 +103,11 @@ since buffered data would then be flushed twice.)
 .Xr wait 2 ,
 .Xr _exit 2 ,
 .Xr exit 3
-.Sh RETURN VALUES
-Same as for
-.Xr fork 2 .
+.Sh HISTORY
+The
+.Fn vfork
+function call appeared in
+.Bx 2.9 .
 .Sh BUGS
 This system call will be eliminated when proper system sharing
 mechanisms are implemented.
@@ -126,8 +131,3 @@ output or
 calls
 are allowed
 and input attempts result in an end-of-file indication.
-.Sh HISTORY
-The
-.Fn vfork
-function call appeared in
-.Bx 2.9 .
index 6eb2b56..07dce02 100644 (file)
@@ -31,7 +31,7 @@
 .\"
 .\"     @(#)wait.2     8.2 (Berkeley) 4/19/94
 .\" $FreeBSD: src/lib/libc/sys/wait.2,v 1.6.2.6 2001/12/14 18:34:02 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/wait.2,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc/sys/wait.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd April 19, 1994
 .Dt WAIT 2
@@ -274,6 +274,11 @@ or the signal did not have the
 .Dv SA_RESTART
 flag set.
 .El
+.Sh SEE ALSO
+.Xr ptrace 2 ,
+.Xr sigaction 2 ,
+.Xr _exit 2 ,
+.Xr exit 3
 .Sh STANDARDS
 The
 .Fn wait
@@ -290,11 +295,6 @@ macro
 and the ability to restart a pending
 .Fn wait
 call are extensions to the POSIX interface.
-.Sh SEE ALSO
-.Xr ptrace 2 ,
-.Xr sigaction 2 ,
-.Xr _exit 2 ,
-.Xr exit 3
 .Sh HISTORY
 A
 .Fn wait
index 7b50736..78567bf 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_attr_get_np.3,v 1.4.2.3 2003/03/03 22:02:43 phantom Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_attr_get_np.3,v 1.2 2003/06/17 04:26:47 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_attr_get_np.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd January 31, 2003
 .Dt PTHREAD_ATTR_GET_NP 3
@@ -67,6 +67,11 @@ The
 .Fn pthread_attr_get_np
 function will always return a pointer to the thread's real stack address,
 regardless of its value in the original attributes structure.
+.Sh RETURN VALUES
+If successful,
+.Fn pthread_attr_get_np
+function returns 0.
+Otherwise, an error number is returned to indicate the error.
 .Sh EXAMPLES
 .Bd -literal
 size_t
@@ -82,11 +87,6 @@ my_thread_stack_size(pthread_t pid)
     return(size);
 }
 .Ed
-.Sh RETURN VALUES
-If successful,
-.Fn pthread_attr_get_np
-function returns 0.
-Otherwise, an error number is returned to indicate the error.
 .Sh ERRORS
 .Fn pthread_attr_get_np
 will fail if:
index b27bc4a..cc2f522 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlock_destroy.3,v 1.3.2.3 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_destroy.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_destroy.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd August 4, 1998
 .Dt PTHREAD_RWLOCK_DESTROY 3
@@ -47,13 +47,6 @@ If successful, the
 .Fn pthread_rwlock_destroy
 function will return zero.  Otherwise an error number will be returned
 to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlock_init 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_destroy
-function is expected to conform to
-.St -susv2 .
 .Sh ERRORS
 The
 .Fn pthread_rwlock_destroy
@@ -76,6 +69,13 @@ The value specified by
 .Fa lock
 is invalid.
 .El
+.Sh SEE ALSO
+.Xr pthread_rwlock_init 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_destroy
+function is expected to conform to
+.St -susv2 .
 .Sh HISTORY
 The
 .Fn pthread_rwlock_destroy
index 4162b97..3a2126d 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlock_init.3,v 1.2.2.3 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_init.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_init.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd August 4, 1998
 .Dt PTHREAD_RWLOCK_INIT 3
@@ -55,15 +55,6 @@ If successful, the
 .Fn pthread_rwlock_init
 function will return zero.  Otherwise an error number will be returned
 to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlockattr_init 3 ,
-.Xr pthread_rwlockattr_setpshared 3 ,
-.Xr pthread_rwlock_destroy 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_init
-function is expected to conform to
-.St -susv2 .
 .Sh ERRORS
 The
 .Fn pthread_rwlock_init
@@ -93,6 +84,15 @@ The value specified by
 .Fa attr
 is invalid.
 .El
+.Sh SEE ALSO
+.Xr pthread_rwlockattr_init 3 ,
+.Xr pthread_rwlockattr_setpshared 3 ,
+.Xr pthread_rwlock_destroy 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_init
+function is expected to conform to
+.St -susv2 .
 .Sh HISTORY
 The
 .Fn pthread_rwlock_init
index d3e1dc1..acca555 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlock_rdlock.3,v 1.2.2.2 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_rdlock.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_rdlock.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd August 4, 1998
 .Dt PTHREAD_RWLOCK_RDLOCK 3
@@ -73,18 +73,6 @@ and
 .Fn pthread_rwlock_tryrdlock
 functions will return zero.  Otherwise an error number will be returned
 to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlock_init 3 ,
-.Xr pthread_rwlock_trywrlock 3 ,
-.Xr pthread_rwlock_unlock 3 ,
-.Xr pthread_rwlock_wrlock 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_rdlock
-and
-.Fn pthread_rwlock_tryrdlock
-functions are expected to conform to
-.St -susv2 .
 .Sh ERRORS
 The
 .Fn pthread_rwlock_tryrdlock
@@ -118,6 +106,18 @@ is invalid.
 Insufficient memory exists to initialize the lock (applies to
 statically initialized locks only).
 .El
+.Sh SEE ALSO
+.Xr pthread_rwlock_init 3 ,
+.Xr pthread_rwlock_trywrlock 3 ,
+.Xr pthread_rwlock_unlock 3 ,
+.Xr pthread_rwlock_wrlock 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_rdlock
+and
+.Fn pthread_rwlock_tryrdlock
+functions are expected to conform to
+.St -susv2 .
 .Sh HISTORY
 The
 .Fn pthread_rwlock_rdlock
index 4d3de1c..b8075b6 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlock_unlock.3,v 1.2.2.2 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_unlock.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_unlock.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd August 4, 1998
 .Dt PTHREAD_RWLOCK_UNLOCK 3
@@ -55,14 +55,6 @@ to indicate the error.
 The results are undefined if
 .Fa lock
 is not held by the calling thread.
-.Sh SEE ALSO
-.Xr pthread_rwlock_rdlock 3 ,
-.Xr pthread_rwlock_wrlock 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_unlock
-function is expected to conform to
-.St -susv2 .
 .Sh ERRORS
 The
 .Fn pthread_rwlock_unlock
@@ -75,6 +67,14 @@ is invalid.
 .It Bq Er EPERM
 The current thread does not own the read/write lock.
 .El
+.Sh SEE ALSO
+.Xr pthread_rwlock_rdlock 3 ,
+.Xr pthread_rwlock_wrlock 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_unlock
+function is expected to conform to
+.St -susv2 .
 .Sh HISTORY
 The
 .Fn pthread_rwlock_unlock
index ed77336..38e5197 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlock_wrlock.3,v 1.2.2.2 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_wrlock.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlock_wrlock.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd August 4, 1998
 .Dt PTHREAD_RWLOCK_WRLOCK 3
@@ -61,17 +61,6 @@ and
 .Fn pthread_rwlock_trywrlock
 functions will return zero.  Otherwise an error number will be returned
 to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlock_trywrlock 3 ,
-.Xr pthread_rwlock_unlock 3 ,
-.Xr pthread_rwlock_wrlock 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlock_wrlock
-and
-.Fn pthread_rwlock_trywrlock
-functions are expected to conform to
-.St -susv2 .
 .Sh ERRORS
 The
 .Fn pthread_rwlock_trywrlock
@@ -98,6 +87,17 @@ is invalid.
 Insufficient memory exists to initialize the lock (applies to
 statically initialized locks only).
 .El
+.Sh SEE ALSO
+.Xr pthread_rwlock_trywrlock 3 ,
+.Xr pthread_rwlock_unlock 3 ,
+.Xr pthread_rwlock_wrlock 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlock_wrlock
+and
+.Fn pthread_rwlock_trywrlock
+functions are expected to conform to
+.St -susv2 .
 .Sh HISTORY
 The
 .Fn pthread_rwlock_wrlock
index 1bf206f..83f50e7 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlockattr_destroy.3,v 1.3.2.3 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlockattr_destroy.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlockattr_destroy.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd August 4, 1998
 .Dt PTHREAD_RWLOCKATTR_DESTROY 3
@@ -48,13 +48,6 @@ If successful, the
 .Fn pthread_rwlockattr_destroy
 function will return zero.  Otherwise an error number will be returned
 to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlockattr_init 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlockattr_destroy
-function is expected to conform to
-.St -susv2 .
 .Sh ERRORS
 .Fn pthread_rwlockattr_destroy
 may fail if:
@@ -64,6 +57,13 @@ The value specified by
 .Fa attr
 is invalid.
 .El
+.Sh SEE ALSO
+.Xr pthread_rwlockattr_init 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlockattr_destroy
+function is expected to conform to
+.St -susv2 .
 .Sh HISTORY
 The
 .Fn pthread_rwlockattr_destroy
index 4f6a6e2..4607025 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlockattr_getpshared.3,v 1.4.2.4 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlockattr_getpshared.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlockattr_getpshared.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd March 22, 1999
 .Dt PTHREAD_RWLOCKATTR_GETPSHARED 3
@@ -58,15 +58,6 @@ If successful, the
 .Fn pthread_rwlockattr_getpshared
 function will return zero.  Otherwise an error number will be returned
 to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlockattr_init 3 ,
-.Xr pthread_rwlockattr_setpshared 3 ,
-.Xr pthread_rwlock_init 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlockattr_getpshared
-function is expected to conform to
-.St -susv2 .
 .Sh ERRORS
 .Fn pthread_rwlockattr_getpshared
 may fail if:
@@ -76,6 +67,15 @@ The value specified by
 .Fa attr
 is invalid.
 .El
+.Sh SEE ALSO
+.Xr pthread_rwlockattr_init 3 ,
+.Xr pthread_rwlockattr_setpshared 3 ,
+.Xr pthread_rwlock_init 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlockattr_getpshared
+function is expected to conform to
+.St -susv2 .
 .Sh HISTORY
 The
 .Fn pthread_rwlockattr_getpshared
index ecb9348..d129367 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlockattr_init.3,v 1.3.2.3 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlockattr_init.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlockattr_init.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd August 4, 1998
 .Dt PTHREAD_RWLOCKATTR_INIT 3
@@ -46,6 +46,13 @@ If successful, the
 .Fn pthread_rwlockattr_init
 function will return zero.  Otherwise an error number will be returned
 to indicate the error.
+.Sh ERRORS
+.Fn pthread_rwlockattr_init
+will fail if:
+.Bl -tag -width Er
+.It Bq Er ENOMEM
+Insufficient memory exists to initialize the attribute object.
+.El
 .Sh SEE ALSO
 .Xr pthread_rwlockattr_destroy 3 ,
 .Xr pthread_rwlockattr_getpshared 3 ,
@@ -56,13 +63,6 @@ The
 .Fn pthread_rwlockattr_init
 function is expected to conform to
 .St -susv2 .
-.Sh ERRORS
-.Fn pthread_rwlockattr_init
-will fail if:
-.Bl -tag -width Er
-.It Bq Er ENOMEM
-Insufficient memory exists to initialize the attribute object.
-.El
 .Sh HISTORY
 The
 .Fn pthread_rwlockattr_init
index aebb8de..86f9b97 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc_r/man/pthread_rwlockattr_setpshared.3,v 1.3.2.4 2001/12/17 10:08:26 ru Exp $
-.\" $DragonFly: src/lib/libc_r/man/pthread_rwlockattr_setpshared.3,v 1.2 2003/06/17 04:26:48 dillon Exp $
+.\" $DragonFly: src/lib/libc_r/man/pthread_rwlockattr_setpshared.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd August 4, 1998
 .Dt PTHREAD_RWLOCKATTR_SETPSHARED 3
@@ -60,15 +60,6 @@ If successful, the
 .Fn pthread_rwlockattr_setpshared
 function will return zero.  Otherwise an error number will be returned
 to indicate the error.
-.Sh SEE ALSO
-.Xr pthread_rwlockattr_init 3 ,
-.Xr pthread_rwlockattr_setpshared 3 ,
-.Xr pthread_rwlock_init 3
-.Sh STANDARDS
-The
-.Fn pthread_rwlockattr_setpshared
-function is expected to conform to
-.St -susv2 .
 .Sh ERRORS
 .Fn pthread_rwlockattr_setpshared
 will fail if:
@@ -80,6 +71,15 @@ or
 .Fa pshared
 is invalid.
 .El
+.Sh SEE ALSO
+.Xr pthread_rwlockattr_init 3 ,
+.Xr pthread_rwlockattr_setpshared 3 ,
+.Xr pthread_rwlock_init 3
+.Sh STANDARDS
+The
+.Fn pthread_rwlockattr_setpshared
+function is expected to conform to
+.St -susv2 .
 .Sh HISTORY
 The
 .Fn pthread_rwlockattr_setpshared
index 0714dcb..a148c01 100644 (file)
@@ -28,7 +28,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    $FreeBSD: src/lib/libcrypt/crypt.3,v 1.6.2.14 2002/12/29 16:35:35 schweikh Exp $
-.\"    $DragonFly: src/lib/libcrypt/crypt.3,v 1.3 2006/02/10 19:01:09 swildner Exp $
+.\"    $DragonFly: src/lib/libcrypt/crypt.3,v 1.4 2006/02/17 19:35:07 swildner Exp $
 .\"
 .\" Manual page, using -mandoc macros
 .\"
@@ -243,14 +243,6 @@ Otherwise, a value of 0 is returned.
 .Xr getpass 3 ,
 .Xr auth.conf 5 ,
 .Xr passwd 5
-.Sh BUGS
-The
-.Fn crypt
-function returns a pointer to static data, and subsequent calls to
-.Fn crypt
-will modify the same data.  Likewise,
-.Fn crypt_set_format
-modifies static data.
 .Sh HISTORY
 A rotor-based
 .Fn crypt
@@ -279,3 +271,11 @@ later additions and changes by
 .An Paul Herman
 and
 .An Niels Provos .
+.Sh BUGS
+The
+.Fn crypt
+function returns a pointer to static data, and subsequent calls to
+.Fn crypt
+will modify the same data.  Likewise,
+.Fn crypt_set_format
+modifies static data.
index 017b942..cf75de0 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libftpio/ftpio.3,v 1.21.2.9 2002/12/29 16:35:35 schweikh Exp $
-.\" $DragonFly: src/lib/libftpio/ftpio.3,v 1.2 2003/06/17 04:26:49 dillon Exp $
+.\" $DragonFly: src/lib/libftpio/ftpio.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd June 17, 1996
 .Dt FTPIO 3
@@ -218,10 +218,6 @@ to ``NO'' or ``no'' in which case active mode is forced.
 If defined, the setting of this variable always overrides any calls to
 .Fn ftpPassive .
 .El
-.Sh BUGS
-I'm sure you can get this thing's internal state machine confused if
-you really work at it, but so far it's proven itself pretty robust in
-all my tests.
 .Sh HISTORY
 Started life as Poul-Henning Kamp's ftp driver for the system installation
 utility, later significantly mutated into a more general form as an
@@ -232,3 +228,7 @@ extensions from Jean-Marc Zucconi.
 .An Poul-Henning Kamp
 and
 .An Jean-Marc Zucconi
+.Sh BUGS
+I'm sure you can get this thing's internal state machine confused if
+you really work at it, but so far it's proven itself pretty robust in
+all my tests.
index 1357416..29e3511 100644 (file)
@@ -35,7 +35,7 @@
 .\"
 .\"     @(#)kvm_geterr.3       8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libkvm/kvm_geterr.3,v 1.3.2.4 2001/12/17 10:08:30 ru Exp $
-.\" $DragonFly: src/lib/libkvm/kvm_geterr.3,v 1.2 2003/06/17 04:26:49 dillon Exp $
+.\" $DragonFly: src/lib/libkvm/kvm_geterr.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt KVM_GETERR 3
@@ -59,17 +59,6 @@ library call did not produce an error.
 The string returned is stored in memory owned by
 .Xr kvm 3
 so the message should be copied out and saved elsewhere if necessary.
-.Sh BUGS
-This routine cannot be used to access error conditions due to a failed
-.Fn kvm_openfiles
-call, since failure is indicated by returning a
-.Dv NULL
-descriptor.
-Therefore, errors on open are output to the special error buffer
-passed to
-.Fn kvm_openfiles .
-This option is not available to
-.Fn kvm_open .
 .Sh SEE ALSO
 .Xr kvm 3 ,
 .Xr kvm_close 3 ,
@@ -81,3 +70,14 @@ This option is not available to
 .Xr kvm_openfiles 3 ,
 .Xr kvm_read 3 ,
 .Xr kvm_write 3
+.Sh BUGS
+This routine cannot be used to access error conditions due to a failed
+.Fn kvm_openfiles
+call, since failure is indicated by returning a
+.Dv NULL
+descriptor.
+Therefore, errors on open are output to the special error buffer
+passed to
+.Fn kvm_openfiles .
+This option is not available to
+.Fn kvm_open .
index 66a8bbb..ddf583a 100644 (file)
@@ -35,7 +35,7 @@
 .\"
 .\"     @(#)kvm_getfiles.3     8.2 (Berkeley) 4/19/94
 .\" $FreeBSD: src/lib/libkvm/kvm_getfiles.3,v 1.6.2.6 2001/12/17 10:08:30 ru Exp $
-.\" $DragonFly: src/lib/libkvm/kvm_getfiles.3,v 1.2 2003/06/17 04:26:49 dillon Exp $
+.\" $DragonFly: src/lib/libkvm/kvm_getfiles.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd April 19, 1994
 .Dt KVM_GETFILES 3
@@ -75,8 +75,6 @@ saved.
 .Sh RETURN VALUES
 .Fn kvm_getfiles
 will return NULL on failure.
-.Sh BUGS
-This routine does not belong in the kvm interface.
 .Sh SEE ALSO
 .Xr kvm 3 ,
 .Xr kvm_close 3 ,
@@ -86,3 +84,5 @@ This routine does not belong in the kvm interface.
 .Xr kvm_openfiles 3 ,
 .Xr kvm_read 3 ,
 .Xr kvm_write 3
+.Sh BUGS
+This routine does not belong in the kvm interface.
index dd83bff..e4dc1a5 100644 (file)
@@ -35,7 +35,7 @@
 .\"
 .\"     @(#)kvm_getprocs.3     8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libkvm/kvm_getprocs.3,v 1.6.2.7 2003/04/29 14:37:04 trhodes Exp $
-.\" $DragonFly: src/lib/libkvm/kvm_getprocs.3,v 1.2 2003/06/17 04:26:49 dillon Exp $
+.\" $DragonFly: src/lib/libkvm/kvm_getprocs.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd June 4, 1993
 .Dt KVM_GETPROCS 3
@@ -153,8 +153,6 @@ and
 all return
 .Dv NULL
 on failure.
-.Sh BUGS
-These routines do not belong in the kvm interface.
 .Sh SEE ALSO
 .Xr kvm 3 ,
 .Xr kvm_close 3 ,
@@ -164,3 +162,5 @@ These routines do not belong in the kvm interface.
 .Xr kvm_openfiles 3 ,
 .Xr kvm_read 3 ,
 .Xr kvm_write 3
+.Sh BUGS
+These routines do not belong in the kvm interface.
index 919a6ba..5db722a 100644 (file)
@@ -35,7 +35,7 @@
 .\"
 .\"     @(#)kvm_open.3 8.3 (Berkeley) 4/19/94
 .\" $FreeBSD: src/lib/libkvm/kvm_open.3,v 1.5.2.6 2001/12/17 10:08:30 ru Exp $
-.\" $DragonFly: src/lib/libkvm/kvm_open.3,v 1.2 2003/06/17 04:26:49 dillon Exp $
+.\" $DragonFly: src/lib/libkvm/kvm_open.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd April 19, 1994
 .Dt KVM_OPEN 3
@@ -174,12 +174,6 @@ writes the error message into
 The
 .Fn kvm_close
 function returns 0 on success and -1 on failure.
-.Sh BUGS
-There should not be two open calls.  The ill-defined error semantics
-of the Sun library and the desire to have a backward-compatible library
-for
-.Bx
-left little choice.
 .Sh SEE ALSO
 .Xr open 2 ,
 .Xr kvm 3 ,
@@ -190,3 +184,9 @@ left little choice.
 .Xr kvm_nlist 3 ,
 .Xr kvm_read 3 ,
 .Xr kvm_write 3
+.Sh BUGS
+There should not be two open calls.  The ill-defined error semantics
+of the Sun library and the desire to have a backward-compatible library
+for
+.Bx
+left little choice.
index 2817225..719c89e 100644 (file)
@@ -7,7 +7,7 @@
 .\" ----------------------------------------------------------------------------
 .\"
 .\" $FreeBSD: src/lib/libmd/mdX.3,v 1.16.2.5 2001/12/17 10:08:31 ru Exp $
-.\" $DragonFly: src/lib/libmd/mdX.3,v 1.2 2003/06/17 04:26:50 dillon Exp $
+.\" $DragonFly: src/lib/libmd/mdX.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd February 11, 1999
 .Dt MDX 3
@@ -149,6 +149,9 @@ argument is non-null it must point to at least 33 characters of buffer space.
 .%N 4
 .%D November 12, 1996
 .Re
+.Sh HISTORY
+These functions appeared in
+.Fx 2.0 .
 .Sh AUTHORS
 The original MDX routines were developed by
 .Tn RSA
@@ -157,9 +160,6 @@ This code is derived directly from these implementations by
 .An Poul-Henning Kamp Aq phk@login.dkuug.dk
 .Pp
 Phk ristede runen.
-.Sh HISTORY
-These functions appeared in
-.Fx 2.0 .
 .Sh BUGS
 No method is known to exist which finds two files having the same hash value,
 nor to find a file with a specific hash value.
index 4940810..c9fb139 100644 (file)
@@ -8,7 +8,7 @@
 .\"
 .\"    From: Id: mdX.3,v 1.14 1999/02/11 20:31:49 wollman Exp
 .\" $FreeBSD: src/lib/libmd/ripemd.3,v 1.2.2.5 2001/12/17 10:08:31 ru Exp $
-.\" $DragonFly: src/lib/libmd/ripemd.3,v 1.2 2003/06/17 04:26:50 dillon Exp $
+.\" $DragonFly: src/lib/libmd/ripemd.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd February 26, 1999
 .Dt RIPEMD 3
@@ -99,14 +99,14 @@ argument is non-null it must point to at least 41 characters of buffer space.
 .Xr md4 3 ,
 .Xr md5 3 ,
 .Xr sha 3
+.Sh HISTORY
+These functions appeared in
+.Fx 4.0 .
 .Sh AUTHORS
 The core hash routines were implemented by Eric Young based on the
 published
 .Tn RIPEMD160
 specification.
-.Sh HISTORY
-These functions appeared in
-.Fx 4.0 .
 .Sh BUGS
 No method is known to exist which finds two files having the same hash value,
 nor to find a file with a specific hash value.
index 94f5f4f..d06d316 100644 (file)
@@ -8,7 +8,7 @@
 .\"
 .\"    From: Id: mdX.3,v 1.14 1999/02/11 20:31:49 wollman Exp
 .\" $FreeBSD: src/lib/libmd/sha.3,v 1.4.2.5 2001/12/17 10:08:31 ru Exp $
-.\" $DragonFly: src/lib/libmd/sha.3,v 1.2 2003/06/17 04:26:50 dillon Exp $
+.\" $DragonFly: src/lib/libmd/sha.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd February 25, 1999
 .Dt SHA 3
@@ -129,14 +129,14 @@ argument is non-null it must point to at least 41 characters of buffer space.
 .Xr md4 3 ,
 .Xr md5 3 ,
 .Xr ripemd 3
+.Sh HISTORY
+These functions appeared in
+.Fx 4.0 .
 .Sh AUTHORS
 The core hash routines were implemented by Eric Young based on the
 published
 .Tn FIPS
 standards.
-.Sh HISTORY
-These functions appeared in
-.Fx 4.0 .
 .Sh BUGS
 No method is known to exist which finds two files having the same hash value,
 nor to find a file with a specific hash value.
index fcc0aad..a24f74e 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libskey/skey.3,v 1.10.2.1 2000/04/22 16:36:00 phantom Exp $
-.\" $DragonFly: src/lib/libskey/skey.3,v 1.3 2005/08/01 01:49:16 swildner Exp $
+.\" $DragonFly: src/lib/libskey/skey.3,v 1.4 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd December 22, 1996
 .Dt SKEY 3
@@ -152,13 +152,13 @@ See above.
 .Sh SEE ALSO
 .Xr skey 1 ,
 .Xr skey.access 5
-.Sh BUGS
-No advisory locking is done on the s/key database to guard against
-simultaneous access from multiple processes.
-This is not normally a problem when keys are added to or updated
-in the file, but may be problematic when keys are removed.
 .Sh AUTHORS
 .An Phil Karn ,
 .An Neil M. Haller ,
 .An John S. Walden ,
 .An Scott Chasin
+.Sh BUGS
+No advisory locking is done on the s/key database to guard against
+simultaneous access from multiple processes.
+This is not normally a problem when keys are added to or updated
+in the file, but may be problematic when keys are removed.
index 2e6f6b5..7c8c397 100644 (file)
@@ -1,5 +1,5 @@
 .\" $FreeBSD: src/lib/libskey/skey.access.5,v 1.5.2.1 2001/01/12 18:06:50 ru Exp $
-.\" $DragonFly: src/lib/libskey/skey.access.5,v 1.2 2003/06/17 04:26:51 dillon Exp $
+.\" $DragonFly: src/lib/libskey/skey.access.5,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd January 12, 2001
 .Dt SKEY.ACCESS 5
@@ -109,6 +109,16 @@ True when the user attempts to log in as a member of the
 .Ar wheel
 group.
 .El
+.Sh FILES
+.Bl -tag -width /etc/skey.access
+.It Pa /etc/skey.access
+password control table
+.El
+.Sh DIAGNOSTICS
+Syntax errors are reported to the
+.Xr syslogd 8 .
+When an error is found
+the rule is skipped.
 .Sh COMPATIBILITY
 For the sake of backwards compatibility, the
 .Ic internet
@@ -206,16 +216,6 @@ the
 routines ignore network addresses that appear to
 belong to someone else.
 .El
-.Sh DIAGNOSTICS
-Syntax errors are reported to the
-.Xr syslogd 8 .
-When an error is found
-the rule is skipped.
-.Sh FILES
-.Bl -tag -width /etc/skey.access
-.It Pa /etc/skey.access
-password control table
-.El
 .Sh SEE ALSO
 .Xr login 1 ,
 .Xr syslogd 8
index 90a8a17..417e152 100644 (file)
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libstand/libstand.3,v 1.5.2.11 2002/06/26 19:14:43 schweikh Exp $
-.\" $DragonFly: src/lib/libstand/libstand.3,v 1.4 2004/09/14 00:22:15 drhodus Exp $
+.\" $DragonFly: src/lib/libstand/libstand.3,v 1.5 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd September 13, 2004
 .Dt LIBSTAND 3
@@ -617,8 +617,6 @@ pointers should be terminated with a NULL.
 Devices are exported by the supporting code via the array
 .Vt struct devsw *devsw[]
 which is a NULL terminated array of pointers to device switch structures.
-.Sh BUGS
-The lack of detailed memory usage data is unhelpful.
 .Sh HISTORY
 .Nm
 contains contributions from many sources, including:
@@ -643,3 +641,5 @@ The reorganisation and port to
 .Fx 3.0 ,
 the environment functions and this manpage were written by
 .An Mike Smith Aq msmith@FreeBSD.org .
+.Sh BUGS
+The lack of detailed memory usage data is unhelpful.
index 0cdf371..bad8d4f 100644 (file)
@@ -1,6 +1,6 @@
 .\"    $NetBSD: usb.3,v 1.13 2000/09/24 02:17:52 augustss Exp $
 .\"    $FreeBSD: src/lib/libusbhid/usbhid.3,v 1.11.2.1 2002/04/03 15:54:00 joe Exp $
-.\"    $DragonFly: src/lib/libusbhid/usbhid.3,v 1.2 2003/06/17 04:26:51 dillon Exp $
+.\"    $DragonFly: src/lib/libusbhid/usbhid.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .\" Copyright (c) 1999 Lennart Augustsson <augustss@netbsd.org>
 .\" All rights reserved.
@@ -191,13 +191,11 @@ function extracts the value of the item.
 Conversely
 .Fn hid_set_data
 can be used to put data into a report (which must be zeroed first).
-.Sh EXAMPLES
-Not yet.
 .Sh FILES
 .Pa /usr/share/misc/usb_hid_usages
 The default HID usage table.
-.Sh BUGS
-This man page is woefully incomplete.
+.Sh EXAMPLES
+Not yet.
 .Sh SEE ALSO
 The
 .Tn USB
@@ -211,3 +209,5 @@ The
 .Nm
 library first appeared in
 .Nx 1.5 .
+.Sh BUGS
+This man page is woefully incomplete.
index 8c72619..39318d6 100644 (file)
@@ -18,7 +18,7 @@
 .\"    conditions are met.
 .\"
 .\" $FreeBSD: src/lib/libutil/_secure_path.3,v 1.7.2.4 2002/03/19 01:49:54 dd Exp $
-.\" $DragonFly: src/lib/libutil/_secure_path.3,v 1.2 2003/06/17 04:26:51 dillon Exp $
+.\" $DragonFly: src/lib/libutil/_secure_path.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd May 2, 1997
 .Os
@@ -62,10 +62,6 @@ considered secure, -2 if the file does not exist, and
 .Xr syslog 3
 is used to log any failure of this function, including the
 reason, at LOG_ERR priority.
-.Sh BUGS
-The checks carried out are rudimentary and no attempt is made
-to eliminate race conditions between use of this function and
-access to the file referenced.
 .Sh SEE ALSO
 .Xr lstat 2 ,
 .Xr syslog 3
@@ -73,3 +69,7 @@ access to the file referenced.
 Code from which this function was derived was contributed to the
 .Fx
 project by Berkeley Software Design, Inc.
+.Sh BUGS
+The checks carried out are rudimentary and no attempt is made
+to eliminate race conditions between use of this function and
+access to the file referenced.
index e4fa660..a8a4a4c 100644 (file)
@@ -24,7 +24,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libutil/auth.3,v 1.4.2.5 2002/12/29 16:35:36 schweikh Exp $
-.\" $DragonFly: src/lib/libutil/auth.3,v 1.2 2003/06/17 04:26:51 dillon Exp $
+.\" $DragonFly: src/lib/libutil/auth.3,v 1.3 2006/02/17 19:35:07 swildner Exp $
 .\" "
 .Dd October 7, 1998
 .Os
@@ -46,12 +46,12 @@ The function
 returns the value associated with the field called
 .Fa name
 or NULL if no such field is found or the auth file cannot be opened.
+.Sh FILES
+.Pa /etc/auth.conf
+contains the name=value pairs looked up by
+.Fn auth_getval .
 .Sh SEE ALSO
 .Xr properties_free 3 ,
 .Xr properties_read 3 ,
 .Xr property_find 3 ,
 .Xr auth.conf 5
-.Sh FILES
-.Pa /etc/auth.conf
-contains the name=value pairs looked up by
-.Fn auth_getval .
index 74c92ef..8d7b596 100644 (file)
@@ -18,7 +18,7 @@
 .\"    conditions are met.
 .\"
 .\" $FreeBSD: src/lib/libutil/login.conf.5,v 1.22.2.18 2003/05/10 23:30:54 murray Exp $
-.\" $DragonFly: src/lib/libutil/login.conf.5,v 1.4 2004/04/22 16:52:55 dillon Exp $
+.\" $DragonFly: src/lib/libutil/login.conf.5,v 1.5 2006/02/17 19:35:07 swildner Exp $
 .\"
 .Dd November 22, 1996
 .Dt LOGIN.CONF 5
@@ -382,10 +382,6 @@ Similarly with the
 and
 .Em host.exempt
 lists.
-.Sh BUGS
-The
-.Em idletime
-setting is not enforced.
 .Sh SEE ALSO
 .Xr cap_mkdb 1 ,
 .Xr login 1 ,
@@ -395,3 +391,7 @@ setting is not enforced.
 .Xr login_class 3 ,
 .Xr passwd 5 ,
 .Xr ttys 5
+.Sh BUGS
+The
+.Em idletime
+setting is not enforced.
index 76685ef..fb886b2 100644 (file)
@@ -24,7 +24,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libutil/property.3,v 1.8.2.7 2001/12/17 10:08:32 ru Exp $
-.\" $DragonFly: src/lib/libutil/property.3,v 1.3 2005/08/05 21:45:46 swildner Exp $
+.\" $DragonFly: src/lib/libutil/property.3,v 1.4 2006/02/17 19:35:07 swildner Exp $
 .\" "
 .Dd October 7, 1998
 .Os
@@ -89,7 +89,7 @@ characters.  Any line beginning with a # or ; character is assumed to
 be a comment and will be ignored.
 .Sh SEE ALSO
 .Xr auth_getval 3
-.Sh BUGS
-Simplistic.
 .Sh AUTHORS
 .An Jordan Hubbard
+.Sh BUGS
+Simplistic.
index 296905e..466b472 100644 (file)
@@ -25,7 +25,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libvgl/vgl.3,v 1.12.2.8 2001/12/17 10:08:35 ru Exp $
-.\" $DragonFly: src/lib/libvgl/vgl.3,v 1.3 2004/03/11 12:28:53 hmp Exp $
+.\" $DragonFly: src/lib/libvgl/vgl.3,v 1.4 2006/02/17 19:35:07 swildner Exp $
 .Dd November 7, 1999
 .Dt VGL 3
 .Os
@@ -456,10 +456,10 @@ to control screen switching and the mouse pointer,
 and are not available to
 .Nm libvgl
 client programs.
-.Sh AUTHORS
-.An S\(/oren Schmidt Aq sos@FreeBSD.org
 .Sh HISTORY
 The
 .Nm vgl
 library appeared in
 .Fx 3.0 .
+.Sh AUTHORS
+.An S\(/oren Schmidt Aq sos@FreeBSD.org