diff options
Diffstat (limited to 'lib/libutil')
-rw-r--r-- | lib/libutil/fparseln.3 | 5 | ||||
-rw-r--r-- | lib/libutil/opendev.3 | 5 | ||||
-rw-r--r-- | lib/libutil/openpty.3 | 11 | ||||
-rw-r--r-- | lib/libutil/pw_getconf.3 | 5 | ||||
-rw-r--r-- | lib/libutil/pw_init.3 | 17 | ||||
-rw-r--r-- | lib/libutil/pw_lock.3 | 8 | ||||
-rw-r--r-- | lib/libutil/scsi.3 | 42 | ||||
-rw-r--r-- | lib/libutil/uucplock.3 | 16 |
8 files changed, 65 insertions, 44 deletions
diff --git a/lib/libutil/fparseln.3 b/lib/libutil/fparseln.3 index d2be79cde04..fb1234a73ef 100644 --- a/lib/libutil/fparseln.3 +++ b/lib/libutil/fparseln.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fparseln.3,v 1.4 2000/01/05 18:51:11 deraadt Exp $ +.\" $OpenBSD: fparseln.3,v 1.5 2002/05/01 08:03:30 mpech Exp $ .\" $NetBSD: fparseln.3,v 1.7 1999/07/02 15:49:12 simonb Exp $ .\" .\" Copyright (c) 1997 Christos Zoulas. All rights reserved. @@ -49,7 +49,8 @@ function returns a pointer to the next logical line from the stream referenced by .Fa stream . This string is null terminated and dynamically allocated on each -invocation. It is the responsibility of the caller to free the pointer. +invocation. +It is the responsibility of the caller to free the pointer. .Pp By default, if a character is escaped, both it and the preceding escape character will be present in the returned string. diff --git a/lib/libutil/opendev.3 b/lib/libutil/opendev.3 index da874e58597..9c9e3f15cf3 100644 --- a/lib/libutil/opendev.3 +++ b/lib/libutil/opendev.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: opendev.3,v 1.14 2002/04/30 16:31:42 mpech Exp $ +.\" $OpenBSD: opendev.3,v 1.15 2002/05/01 08:03:30 mpech Exp $ .\" .\" Copyright (c) 2000, Todd C. Miller. All rights reserved. .\" Copyright (c) 1996, Jason Downs. All rights reserved. @@ -39,7 +39,8 @@ The .Fn opendev function opens a device using the .Dq short form -name. This is typically +name. +This is typically .Dq sd0 or .Dq sd0c , diff --git a/lib/libutil/openpty.3 b/lib/libutil/openpty.3 index 6d7052a7a13..f752b5c6080 100644 --- a/lib/libutil/openpty.3 +++ b/lib/libutil/openpty.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: openpty.3,v 1.7 2001/07/13 22:14:07 millert Exp $ +.\" $OpenBSD: openpty.3,v 1.8 2002/05/01 08:03:30 mpech Exp $ .\" Copyright (c) 1995 .\" The Regents of the University of California. All rights reserved. .\" @@ -103,12 +103,14 @@ function combines .Fn fork , and .Fn login_tty -to creates a new process operating in a pseudo-tty. The file +to creates a new process operating in a pseudo-tty. +The file descriptor of the master side of the pseudo-tty is returned in .Fa amaster , and the filename of the slave in .Fa name -if it is non-null. The +if it is non-null. +The .Fa termp and .Fa winp @@ -122,7 +124,8 @@ or .Fn forkpty is not successful, \-1 is returned and .Va errno -is set to indicate the error. Otherwise, +is set to indicate the error. +Otherwise, .Fn openpty , .Fn login_tty , and the child process of diff --git a/lib/libutil/pw_getconf.3 b/lib/libutil/pw_getconf.3 index c7a89a92000..f184a9cc3cd 100644 --- a/lib/libutil/pw_getconf.3 +++ b/lib/libutil/pw_getconf.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pw_getconf.3,v 1.7 2001/06/18 21:09:23 millert Exp $ +.\" $OpenBSD: pw_getconf.3,v 1.8 2002/05/01 08:03:30 mpech Exp $ .\" .\" Copyright 1997 Niels Provos <provos@physnet.uni-hamburg.de> .\" All rights reserved. @@ -64,7 +64,8 @@ an empty string will be returned in data. .Pp For default values the key .Pa default -can be used. This might be useful when no entry was found +can be used. +This might be useful when no entry was found for a specific key or option. .Pp An empty string is also returned for other errors. diff --git a/lib/libutil/pw_init.3 b/lib/libutil/pw_init.3 index 672555cbc5b..18a90493a2b 100644 --- a/lib/libutil/pw_init.3 +++ b/lib/libutil/pw_init.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pw_init.3,v 1.4 1999/09/23 04:12:01 alex Exp $ +.\" $OpenBSD: pw_init.3,v 1.5 2002/05/01 08:03:30 mpech Exp $ .\" .\" Copyright (c) 1995 .\" The Regents of the University of California. All rights reserved. @@ -69,7 +69,8 @@ .Fn pw_error "const char *name" "int err" "int eval" .Sh DESCRIPTION These functions are designed as conveniences for interactive programs -which update the passwd file and do nothing else. They generally +which update the passwd file and do nothing else. +They generally handle errors by printing out a message to the standard error stream and possibly aborting the process. .Pp @@ -83,7 +84,8 @@ disabling most signals. The .Fn pw_setdir function sets an alternative directory where the rest of the functions looks -for password-related files. Use this if you are writing utilities that should +for password-related files. +Use this if you are writing utilities that should be able to handle password files outside of /etc. .Pp The @@ -91,7 +93,8 @@ The function transforms filenames so that they end up in the directory specified to the latest .Fn pw_setdir -call. The rule is that all directories are stripped off the given name and +call. +The rule is that all directories are stripped off the given name and only the filename is appended to the directory. .Pp The @@ -104,7 +107,8 @@ if EDITOR is not set) on the file .Pa /etc/ptmp if .Fa filename -is NULL). If +is NULL). +If .Fa notsetuid is nonzero, .Fn pw_edit @@ -170,7 +174,8 @@ is empty. The .Fn pw_error function displays an error message, aborts the current passwd update, -and exits the current process. If +and exits the current process. +If .Fa err is non-zero, a warning message beginning with .Fa name diff --git a/lib/libutil/pw_lock.3 b/lib/libutil/pw_lock.3 index 78d42acba54..d109dc79c64 100644 --- a/lib/libutil/pw_lock.3 +++ b/lib/libutil/pw_lock.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pw_lock.3,v 1.8 2001/08/26 03:28:30 millert Exp $ +.\" $OpenBSD: pw_lock.3,v 1.9 2002/05/01 08:03:30 mpech Exp $ .\" .\" Copyright (c) 1995 .\" The Regents of the University of California. All rights reserved. @@ -65,13 +65,15 @@ function attempts to lock the passwd database by creating the file .Pa /etc/ptmp with an exclusive lock (using .Xr flock 2 -semantics) and returns the file descriptor of that file. If +semantics) and returns the file descriptor of that file. +If .Fa retries is greater than zero, .Fn pw_lock will try multiple times to open .Pa /etc/ptmp , -waiting one second between tries. In addition to being a lock file, +waiting one second between tries. +In addition to being a lock file, .Pa /etc/ptmp will also hold the contents of the new passwd file. .Pp diff --git a/lib/libutil/scsi.3 b/lib/libutil/scsi.3 index 28d372a11f4..2a71b75947c 100644 --- a/lib/libutil/scsi.3 +++ b/lib/libutil/scsi.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: scsi.3,v 1.6 2000/11/10 00:06:27 deraadt Exp $ +.\" $OpenBSD: scsi.3,v 1.7 2002/05/01 08:03:30 mpech Exp $ .\" Copyright (c) 1994 HD Associates (hd@world.std.com) .\" All rights reserved. .\" @@ -79,7 +79,8 @@ use the SCIOCCOMMAND of the SCSI subsystem to provide user level access to SCSI commands. The programmer must know the SCSI CDB (Command Descriptor -Block) to perform the desired command. These functions assist in +Block) to perform the desired command. +These functions assist in building up the CDB, submitting it to the SCSI subsystem, and decoding the result. .Pp @@ -89,7 +90,8 @@ command before using the library directly - simple programs are best implemented as scripts using that facility. .Pp To provide for security, -not all devices accept the SCIOCCOMAND ioctl. It is accepted by the +not all devices accept the SCIOCCOMAND ioctl. +It is accepted by the control device for tape drives, partition D for disk drives, partition C for CD ROM drives, and any "unknown" device. The "super scsi" @@ -145,8 +147,8 @@ determined by the argument. .Pp .Fr buf -is the data buffer used during the SCSI data phase. If it is NULL it -is allocated via malloc and +is the data buffer used during the SCSI data phase. +If it is NULL it is allocated via malloc and .Ar scsireq->databuf is set to point to the newly allocated memory. .Pp @@ -171,17 +173,17 @@ indicates a data out phase (a transfer out of the user buffer). .Pp .Fr fmt is a CDB format specifier used to build up the SCSI CDB. -This text string is made up of a list of field specifiers. Field -specifiers specify the value for each CDB field (including indicating +This text string is made up of a list of field specifiers. +Field specifiers specify the value for each CDB field (including indicating that the value be taken from the next argument in the variable argument list), the width -of the field in bits or bytes, and an optional name. White space is -ignored, and the pound sign ('#') introduces a comment that ends at the -end of the current line. +of the field in bits or bytes, and an optional name. +White space is ignored, and the pound sign ('#') introduces a comment that +ends at the end of the current line. .Pp The optional name is the first part of a field specifier and -is in curly braces. The text in curly braces in this example are -the names: +is in curly braces. +The text in curly braces in this example are the names: .Bd -literal -offset indent .Fr "{PS} v:b1 {Reserved} 0:b1 {Page Code} v:b6 # Mode select page" .Ed @@ -277,8 +279,8 @@ described above in .Fn scsireq_decode . .Pp .Fn scsireq_encode -encodes the data phase section of the structure. The encoding is -handled identically as the encoding of the CDB structure by +encodes the data phase section of the structure. +The encoding is handled identically as the encoding of the CDB structure by .Fn scsireq_build .Pp .Fn scsireq_enter @@ -330,11 +332,14 @@ returns the result of the ioctl call. .Xr scsi 4 , .Xr scsi 8 .Sh BUGS -This only works completely for the 1542C. The host adapter code +This only works completely for the 1542C. +The host adapter code that sets up the residual amount of data transfer has to be added -to each individual adapter. This library is usable on the other +to each individual adapter. +This library is usable on the other host adapters; however, the SCSI driver pretends that the proper -amount of data is always transferred. If you have an Adaptec 174x +amount of data is always transferred. +If you have an Adaptec 174x and can hack contact dufault@hda.com and you can have the code to calculate residual data for the 174x series to integrate and test. .Sh HISTORY @@ -342,7 +347,8 @@ Many systems have comparable interfaces to permit a user to construct a SCSI command in user space. .Pp The data structure is almost identical to the SGI /dev/scsi data -structure. If anyone knows the name of the authors it should +structure. +If anyone knows the name of the authors it should go here; Peter Dufault first read about it in a 1989 Sun Expert magazine. .Pp Peter Dufault implemented a clone of SGI's interface in 386bsd that diff --git a/lib/libutil/uucplock.3 b/lib/libutil/uucplock.3 index 07b19a68869..c52cb84630f 100644 --- a/lib/libutil/uucplock.3 +++ b/lib/libutil/uucplock.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: uucplock.3,v 1.12 2001/08/06 10:42:26 mpech Exp $ +.\" $OpenBSD: uucplock.3,v 1.13 2002/05/01 08:03:30 mpech Exp $ .\" .\" All rights reserved. .\" @@ -123,7 +123,8 @@ the reason for failure is returned. .Fn uu_lockerr uses the current value of .Va errno -to determine the exact error. Care should be made not to allow +to determine the exact error. +Care should be made not to allow .Va errno to be changed between calls to .Fn uu_lock @@ -134,8 +135,8 @@ and may return any of the following values: .Pp .Dv UU_LOCK_OK : -The transfer was successful. The specified process now holds the device -lock. +The transfer was successful. +The specified process now holds the device lock. .Pp .Dv UU_LOCK_OWNER_ERR : The current process does not already own a lock on the specified device. @@ -148,8 +149,8 @@ If .Fn uu_lock returns one of the error values above, the global value .Va errno -can be used to determine the cause. Refer to the respective manual pages -for further details. +can be used to determine the cause. +Refer to the respective manual pages for further details. .Pp .Fn uu_unlock will set the global variable @@ -170,6 +171,7 @@ the stale lock. .Pp The calling process must have write permissions to the .Pa /var/spool/lock -directory. There is no mechanism in place to ensure that the +directory. +There is no mechanism in place to ensure that the permissions of this directory are the same as those of the serial devices that might be locked. |