diff options
| author | wiz <wiz@NetBSD.org> | 2002-09-29 14:05:52 +0000 |
|---|---|---|
| committer | wiz <wiz@NetBSD.org> | 2002-09-29 14:05:52 +0000 |
| commit | d6285bbf1da43763d943e2c3ab6c2ddc2d52fa74 (patch) | |
| tree | 951cc50bf8af18970bc970f806e6a509f51ddab8 /libexec | |
| parent | b6e0393610d0fad3d419b8cf63a55094804121a1 (diff) | |
Begin new sentences on new lines.
Patch from Robert Elz (kre at munnari oz au).
Diffstat (limited to 'libexec')
| -rw-r--r-- | libexec/comsat/comsat.8 | 6 | ||||
| -rw-r--r-- | libexec/ftpd/ftpd.conf.5 | 12 | ||||
| -rw-r--r-- | libexec/getNAME/getNAME.8 | 8 | ||||
| -rw-r--r-- | libexec/getty/getty.8 | 4 | ||||
| -rw-r--r-- | libexec/identd/identd.8 | 149 | ||||
| -rw-r--r-- | libexec/ld.aout_so/ld.aout_so.1 | 40 | ||||
| -rw-r--r-- | libexec/ld.elf_so/ld.elf_so.1 | 73 | ||||
| -rw-r--r-- | libexec/lfs_cleanerd/lfs_cleanerd.8 | 33 | ||||
| -rw-r--r-- | libexec/rpc.rstatd/rpc.rstatd.8 | 10 | ||||
| -rw-r--r-- | libexec/rpc.rwalld/rpc.rwalld.8 | 6 | ||||
| -rw-r--r-- | libexec/rshd/rshd.8 | 55 | ||||
| -rw-r--r-- | libexec/telnetd/telnetd.8 | 54 |
12 files changed, 241 insertions, 209 deletions
diff --git a/libexec/comsat/comsat.8 b/libexec/comsat/comsat.8 index 1f40d7d9768..fe0342f84d3 100644 --- a/libexec/comsat/comsat.8 +++ b/libexec/comsat/comsat.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: comsat.8,v 1.9 2002/01/15 02:19:36 wiz Exp $ +.\" $NetBSD: comsat.8,v 1.10 2002/09/29 14:05:52 wiz Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -67,8 +67,8 @@ the .Em offset is used as a seek offset into the appropriate mailbox file and the first 7 lines or 560 characters of the message are printed -on the user's terminal. Lines which appear to be part of -the message header other than the +on the user's terminal. +Lines which appear to be part of the message header other than the .Dq From , .Dq \&To , .Dq Date , diff --git a/libexec/ftpd/ftpd.conf.5 b/libexec/ftpd/ftpd.conf.5 index 5faef495833..9b422ee65f8 100644 --- a/libexec/ftpd/ftpd.conf.5 +++ b/libexec/ftpd/ftpd.conf.5 @@ -1,4 +1,4 @@ -.\" $NetBSD: ftpd.conf.5,v 1.21 2002/05/31 09:56:12 wiz Exp $ +.\" $NetBSD: ftpd.conf.5,v 1.22 2002/09/29 14:05:53 wiz Exp $ .\" .\" Copyright (c) 1997-2001 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -383,7 +383,8 @@ If zero, .Xr ftpd 8 will use .Xr read 2 -instead. The default is zero. +instead. +The default is zero. An optional suffix may be provided as per .Sy rateget . This option affects only binary transfers. @@ -496,7 +497,8 @@ An optional suffix may be provided, which changes the intrepretation of as follows: .Bl -tag -width 3n -offset indent -compact .It b -Causes no modification. (Default; optional) +Causes no modification. +(Default; optional) .It k Kilo; multiply the argument by 1024 .It m @@ -620,8 +622,8 @@ Otherwise, enable them. .It Sy writesize Ar class Ar size Limit the number of bytes to .Xr write 2 -at a time. The default is zero, which means -all the data available as a result of +at a time. +The default is zero, which means all the data available as a result of .Xr mmap 2 or .Xr read 2 diff --git a/libexec/getNAME/getNAME.8 b/libexec/getNAME/getNAME.8 index 2f34eeb9c30..63482bd6173 100644 --- a/libexec/getNAME/getNAME.8 +++ b/libexec/getNAME/getNAME.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: getNAME.8,v 1.9 2002/03/08 20:59:08 jdolecek Exp $ +.\" $NetBSD: getNAME.8,v 1.10 2002/09/29 14:05:53 wiz Exp $ .\" .\" Copyright (c) 1997 Matthew R. Green .\" All rights reserved. @@ -41,7 +41,8 @@ The .Nm utility looks inside manual page sources to find the name of the page. It can be used to create a table of contents, report the style of manual, -or to create an introductory manual page. By default, +or to create an introductory manual page. +By default, .Nm returns data for use in an .Xr apropos 1 @@ -58,7 +59,8 @@ to get manpage names, but that's no longer the case. The following options are available: .Bl -tag -width Ds .It Fl i -Print information useful in creating an introduction manual. See +Print information useful in creating an introduction manual. +See .Xr intro 1 , .Xr intro 2 , etc. for examples. diff --git a/libexec/getty/getty.8 b/libexec/getty/getty.8 index df508958cdd..a787da57619 100644 --- a/libexec/getty/getty.8 +++ b/libexec/getty/getty.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: getty.8,v 1.15 2002/01/15 02:21:30 wiz Exp $ +.\" $NetBSD: getty.8,v 1.16 2002/09/29 14:05:53 wiz Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -72,7 +72,7 @@ negotiation, and, if the .Sy pp attribute in .Xr gettytab 5 -is set, invoke the program given by that string, e.g. +is set, invoke the program given by that string, e.g., .Xr pppd 8 , instead of .Xr login 1 . diff --git a/libexec/identd/identd.8 b/libexec/identd/identd.8 index 1dc361134aa..7cd4b1b408a 100644 --- a/libexec/identd/identd.8 +++ b/libexec/identd/identd.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: identd.8,v 1.12 2002/03/28 15:09:14 sommerfeld Exp $ +.\" $NetBSD: identd.8,v 1.13 2002/09/29 14:05:53 wiz Exp $ .\" .\" @(#)identd.8 1.9 92/02/11 Lysator .\" Copyright (c) 1992 Peter Eriksson, Lysator, Linkoping University. @@ -38,11 +38,11 @@ protocol specified in .B identd operates by looking up specific .SM TCP/IP -connections and returning information which may or may not be +connections and returning information which may or may not be associated with the process owning the connection. .PP -The -.B identd +The +.B identd server provides little other than a false sense of security; however, some legacy services require their clients to run ident servers. .SH ARGUMENTS @@ -56,18 +56,19 @@ resulting in both improved efficiency and increased user privacy (you didn't intend to trust my assertion about who I was anyway, right?) .PP This flag provides a way for a site to support services requiring the ident -protocol while providing a standard answer to all ident queries. All queries -to identd will respond with a host type of `OTHER' and a username of +protocol while providing a standard answer to all ident queries. +All queries to identd will respond with a host type +of `OTHER' and a username of .B \*[Lt]user name\*[Gt]. .PP The .B \-i -flag, enabled by default, should be used when starting the -daemon from +flag, enabled by default, should be used when starting the daemon from .B inetd with the "nowait" option in the .B /etc/inetd.conf -file. Use of this mode will make +file. +Use of this mode will make .B inetd start one .B identd @@ -79,16 +80,16 @@ flag should be used when starting the daemon from .B inetd with the "wait" option in the .B /etc/inetd.conf -file . This is the prefered mode of -operation since that will start a copy of +file. +This is the prefered mode of operation since that will start a copy of .B identd at the first connection request and then .B identd -will handle subsequent requests -without having to do the nlist lookup in the kernel file for -every request as in the +will handle subsequent requests without having to do the +nlist lookup in the kernel file for every request as in the .B \-i -mode above. The +mode above. +The .B identd daemon will run either forever, until a bug makes it crash or a timeout, as specified by the @@ -97,35 +98,34 @@ flag, occurs. .PP The .B \-b -flag can be used to make the daemon run in standalone mode without -the assistance from +flag can be used to make the daemon run in standalone +mode without the assistance from .BR inetd. This mode is the least prefered mode since a bug or any other fatal condition in the server will make it terminate -and it will then have to be restarted manually. Other than that it has the -same advantage as the +and it will then have to be restarted manually. +Other than that it has the same advantage as the .B \-w mode in that it parses the nlist only once. .PP The .B \-t\*[Lt]seconds\*[Gt] -option is used to specify the timeout limit. This is the number -of seconds a server started with the +option is used to specify the timeout limit. +This is the number of seconds a server started with the .B \-w -flag will wait for new connections before terminating. The server is -automatically restarted by +flag will wait for new connections before terminating. +The server is automatically restarted by .B inetd -whenever a new connection is requested -if it has terminated. A suitable value for this is 120 (2 minutes), if -used. It defaults to no timeout (i.e. will wait forever, or until a +whenever a new connection is requested if it has terminated. +A suitable value for this is 120 (2 minutes), if used. +It defaults to no timeout (i.e. will wait forever, or until a fatal condition occurs in the server). .PP The .B \-u\*[Lt]uid\*[Gt] option is used to specify a user id number which the .BR ident -server should -switch to after binding itself to the +server should switch to after binding itself to the .SM TCP/IP port if using the .B \-b @@ -135,8 +135,7 @@ The .B \-g\*[Lt]gid\*[Gt] option is used to specify a group id number which the .BR ident -server should -switch to after binding itself to the +server should switch to after binding itself to the .SM TCP/IP port if using the .B \-b @@ -144,20 +143,23 @@ mode of operation. .PP The .B \-p\*[Lt]port\*[Gt] -option is used to specify an alternative port number to bind to if using -the +option is used to specify an alternative port number +to bind to if using the .B \-b -mode of operation. It can be specified by name or by number. Defaults to the +mode of operation. +It can be specified by name or by number. +Defaults to the .SM IDENT port (113). .PP The .B \-a\*[Lt]address\*[Gt] -option is used to specify the local address to bind the socket to if using -the +option is used to specify the local address to bind +the socket to if using the .B \-b -mode of operation. Can only be specified by IP address and not by domain -name. Defaults to the +mode of operation. +Can only be specified by IP address and not by domain name. +Defaults to the .SM INADDR_ANY address which normally means all local addresses. .PP @@ -236,8 +238,8 @@ The flag makes .B identd check for a file ".noident" in each homedirectory for a user which the -daemon is about to return the user name for. It that file exists then the -daemon will give the error +daemon is about to return the user name for. +It that file exists then the daemon will give the error .B HIDDEN-USER instead of the normal USERID response. .PP @@ -245,9 +247,11 @@ instead of the normal USERID response. flag makes .B identd use a mode of operation that will allow multiple requests to be -processed per session. Each request is specified one per line and -the responses will be returned one per line. The connection will not -be closed until the connecting part closes it's end of the line. +processed per session. +Each request is specified one per line and +the responses will be returned one per line. +The connection will not be closed until the connecting +part closes it's end of the line. PLEASE NOTE THAT THIS MODE VIOLATES THE PROTOCOL SPECIFICATION AS IT CURRENTLY STANDS. .PP @@ -261,7 +265,8 @@ The .B \-F\*[Lt]format\*[Gt] option makes .B identd -use the specified format to display info. The allowed format specifiers are: +use the specified format to display info. +The allowed format specifiers are: .in +.5i .nf %u print user name @@ -276,12 +281,13 @@ use the specified format to display info. The allowed format specifiers are: .in -.5i .fi The lists of groups (%l, %L) are comma-separated, and start with the primary -group which is not repeated. The %p and the %c and %C formats are not -supported on all architecture implementations (printing 0 or empty string -instead). +group which is not repeated. +The %p and the %c and %C formats are not supported on all architecture +implementations (printing 0 or empty string instead). .br -Any other characters (preceded by %, and those not preceded by it) are -printed literally. The "default" format is %u, and you should not use +Any other characters (preceded by %, and those not preceded by it) +are printed literally. +The "default" format is %u, and you should not use anything else without the .B \-o flag. @@ -303,9 +309,11 @@ defaults to the memory space of the normally running kernel. .SH UNDERDOCUMENTED FLAGS The .B \-v -flag enables more verbose output or messages. (Further occurences of the +flag enables more verbose output or messages. +(Further occurences of the .B -v -flag make things even more verbose.) Currently not used: ignored. +flag make things even more verbose.) +Currently not used: ignored. .PP The .B \-f\*[Lt]config-file\*[Gt] @@ -351,7 +359,8 @@ ident stream tcp nowait sys /usr/libexec/identd identd -i .PP into the .B /etc/inetd.conf -file. User "sys" should have enough rights to READ the kernel +file. +User "sys" should have enough rights to READ the kernel but NOT to write to it. .PP To start it using the @@ -362,26 +371,28 @@ file: .PP /usr/libexec/identd -b -u2 -g2 .PP -This will make it run in the background as user 2, group 2 (user "sys", -group "kmem" on SunOS 4.1.1). +This will make it run in the background as user 2, group 2 +(user "sys", group "kmem" on SunOS 4.1.1). .SH NOTES -There should be no need to -ever use this; if you think you need this, you really need protocols +There should be no need to ever use this; +if you think you need this, you really need protocols which do strong host and/or user authentication such as ssh and IPsec in conjunction with audit trails. .Pp -The username (or UID) returned ought to be the login name. However it -(probably, for most architecture implementations) is the "real user ID" as -stored with the process; there is no provision for returning the "effective -user ID". Thus the UID returned may be different from the login name for +The username (or UID) returned ought to be the login name. +However it (probably, for most architecture implementations) +is the "real user ID" as stored with the process; +there is no provision for returning the "effective user ID". +Thus the UID returned may be different from the login name for setuid programs (or those running as root) which done a .BR setuid (2) -call and their children. For example, it may (should?) be wrong for an -incoming +call and their children. +For example, it may (should?) be wrong for an incoming .B ftpd ; and we are probably interested in the running shell, not the .B telnetd -for an incoming telnet session. (But of course +for an incoming telnet session. +(But of course .B identd returns info for outgoing connections, not incoming ones.) .PP @@ -391,12 +402,12 @@ option) are as looked up in the .B /etc/passwd and .B /etc/group -files, based on the UID returned. Thus these may not relate well to the -group(s) of the running process for setuid or setgid programs or their -children. +files, based on the UID returned. +Thus these may not relate well to the group(s) of the running +process for setuid or setgid programs or their children. .PP -The command names returned with formats %c and %C may be different, use -one or the other or both. +The command names returned with formats %c and %C may be different, +use one or the other or both. .SH FILES .TP .B /etc/identd.conf @@ -411,7 +422,7 @@ this file can be used to specify a secret key for encrypting replies. .SH SECURITY CONSIDERATIONS May leak information generally considered "private" unless the .B \-e -flag or +flag or .\"either the .B \-L .\"or @@ -423,7 +434,7 @@ attacks. .SH "SEE ALSO" .BR inetd.conf (5) .SH BUGS -The +The .B \-e and .B \-L diff --git a/libexec/ld.aout_so/ld.aout_so.1 b/libexec/ld.aout_so/ld.aout_so.1 index 258154792fe..68dd438143f 100644 --- a/libexec/ld.aout_so/ld.aout_so.1 +++ b/libexec/ld.aout_so/ld.aout_so.1 @@ -1,4 +1,4 @@ -.\" $NetBSD: ld.aout_so.1,v 1.3 2002/02/07 03:15:07 ross Exp $ +.\" $NetBSD: ld.aout_so.1,v 1.4 2002/09/29 14:05:54 wiz Exp $ .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -42,9 +42,10 @@ .Nd run-time link-editor .Sh DESCRIPTION .Nm -is a self-contained, position independent program image providing run-time -support for loading and link-editing shared objects into a process' -address space. It uses the data structures +is a self-contained, position independent program image +providing run-time support for loading and link-editing +shared objects into a process' address space. +It uses the data structures .Po see .Xr link 5 @@ -58,17 +59,19 @@ system call. After all shared libraries have been successfully loaded, .Nm proceeds to resolve external references from both the main program and -all objects loaded. A mechanism is provided for initialisation routines -to be called, on a per-object basis, giving a shared object an opportunity +all objects loaded. +A mechanism is provided for initialisation routines to be called, +on a per-object basis, giving a shared object an opportunity to perform any extra set-up, before execution of the program proper begins. .Nm looks for a symbol named .Em .init -in each object's symbol table. If present, this symbol is assumed to -represent a C-function declared as +in each object's symbol table. +If present, this symbol is assumed to represent a C-function declared as .Ft void .Fn .init "void" , -which is then called. Similarly, a +which is then called. +Similarly, a .Ft void .Fn .fini "void" function is called just before an object is unloaded from the process @@ -101,8 +104,8 @@ process, .Em crt0 uses the special symbol .Va _DYNAMIC -to determine whether a program is in fact dynamically linked or not. Whenever -the linker +to determine whether a program is in fact dynamically linked or not. +Whenever the linker .Xr ld 1 has relocated this symbol to a location other than 0, .Em crt0 @@ -119,7 +122,8 @@ passes control to .Nm rtld Ns 's entry point before the program's .Fn main -routine is called. Thus, +routine is called. +Thus, .Nm can complete the link-editing process before the dynamic program calls upon services of any dynamic library. @@ -152,11 +156,12 @@ the main program but its shared object dependencies. .It Ev LD_WARN_NON_PURE_CODE When set, issue a warning whenever a link-editing operation requires -modification of the text segment of some loaded object. This is usually -indicative of an incorrectly built library. +modification of the text segment of some loaded object. +This is usually indicative of an incorrectly built library. .It Ev LD_SUPPRESS_WARNINGS -When set, no warning messages of any kind are issued. Normally, a warning -is given if satisfactorily versioned library could not be found. +When set, no warning messages of any kind are issued. +Normally, a warning is given if satisfactorily versioned +library could not be found. .It Ev LD_TRACE_LOADED_OBJECTS When set, causes .Nm @@ -208,7 +213,8 @@ does not process any internal search paths that were recorded in the executable. .It Ev LD_NOSTD_PATH When set, do not include a set of built-in standard directory paths for -searching. This might be useful when running on a system with a completely +searching. +This might be useful when running on a system with a completely non-standard filesystem layout. .El .Sh FILES diff --git a/libexec/ld.elf_so/ld.elf_so.1 b/libexec/ld.elf_so/ld.elf_so.1 index ac1ccb00b06..b278ee01272 100644 --- a/libexec/ld.elf_so/ld.elf_so.1 +++ b/libexec/ld.elf_so/ld.elf_so.1 @@ -1,4 +1,4 @@ -.\" $NetBSD: ld.elf_so.1,v 1.6 2002/09/11 23:11:41 bjh21 Exp $ +.\" $NetBSD: ld.elf_so.1,v 1.7 2002/09/29 14:05:54 wiz Exp $ .\" .\" Copyright (c) 2001 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -42,44 +42,49 @@ .Nd run-time link-editor (linker) .Sh DESCRIPTION .Nm -is a self-contained, position independent program image providing run-time -support for loading and link-editing shared objects into a process' -address space. It uses information stored in data structures within the -binary (see +is a self-contained, position independent program +image providing run-time support for loading and +link-editing shared objects into a process' address space. +It uses information stored in data structures within the binary (see .Xr elf 5 ) and environment variables to determine which shared objects are needed. These shared objects are loaded at a convenient virtual address using the .Xr mmap 2 -system call. After all shared objects have been successfully loaded, +system call. +After all shared objects have been successfully loaded, .Nm -proceeds to resolve external references from both the main program and -all objects loaded. Once all required references are resolved control is +proceeds to resolve external references from both +the main program and all objects loaded. +Once all required references are resolved control is passed to the program via its entry point. .Ss Startup On the execution of a dynamically linked binary the kernel will load the program and its run-time linker as specified in the PT_INTERP -section in the program header. At this point, instead of passing control -directly to the program, the kernel passes control to the specified -linker. An auxiliary vector of information is passed that includes +section in the program header. +At this point, instead of passing control directly to the program, +the kernel passes control to the specified linker. +An auxiliary vector of information is passed that includes the address of the program header, the size of each entry in the header, -and the number of entries. The entry point of the program and the base -address of where +and the number of entries. +The entry point of the program and the base address of where .Nm is loaded is also supplied. .Pp Careful use of code allows .Nm -to relocate itself before proceeding. Specifically the use of global -variables and large switch statements is not allowed. The later can -cause the output of a jump table that can use the equivalent of a -global variable. +to relocate itself before proceeding. +Specifically the use of global variables and +large switch statements is not allowed. +The later can cause the output of a jump table that +can use the equivalent of a global variable. .Ss Finding objects Each .Xr elf 5 object file may contain information in its dynamic (PT_DYNAMIC) section about which shared objects it requires (often referred to as dependencies). These dependencies are specified in the optional DT_NEEDED entry within -the dynamic section. Each DT_NEEDED entry refers to a filename string of +the dynamic section. +Each DT_NEEDED entry refers to a filename string of the shared object that is to be searched for. .Pp The linker will search for libraries in three lists of paths: @@ -92,36 +97,41 @@ The use of ld.so.conf should be avoided as the setting of a global search path can present a security risk. .It A list of paths specified within a shared object using a DT_RPATH entry in -the dynamic section. This is defined at shared object link time. +the dynamic section. +This is defined at shared object link time. .It The list of default paths which is set to .Pa /usr/lib . .El .Pp The filename string can be considered free form, however, it will almost -always take the form lib\*[Lt]name\*[Gt].so.\*[Lt]number\*[Gt], where name specifies the +always take the form lib\*[Lt]name\*[Gt].so.\*[Lt]number\*[Gt], +where name specifies the .Sq library name and number is conceptually the library's major version number. .Pp -This name and another of the form lib\*[Lt]name\*[Gt].so are normally symbolic links -to the real shared object which has a filename of the form +This name and another of the form lib\*[Lt]name\*[Gt].so are normally +symbolic links to the real shared object which has a filename of the form lib\*[Lt]name\*[Gt].so.\*[Lt]major\*[Gt].\*[Lt]minor\*[Gt][.\*[Lt]teeny\*[Gt]]. This naming convention allows a versioning scheme similar to .Xr a.out 5 . .Ss Relocation .Nm will perform all necessary relocations immediately except for relocations -relating to the Procedure Linkage Table (PLT). The PLT is used as a -indirection method for procedure calls to globally defined functions. It -allows, through the use of intermediate code, the delayed binding of a call -to a globally defined function to be performed at procedure call time. This +relating to the Procedure Linkage Table (PLT). +The PLT is used as a indirection method for procedure +calls to globally defined functions. +It allows, through the use of intermediate code, the delayed binding of +a call to a globally defined function to be performed at procedure call time. +This .Sq lazy method is the default (see LD_BIND_NOW). .Ss Initialization A mechanism is provided for initialization and termination routines to be called, on a per-object basis before execution of the program proper -begins or after the program has completed. This gives a shared object an -opportunity to perform any extra set-up or completion work. +begins or after the program has completed. +This gives a shared object an opportunity to perform +any extra set-up or completion work. .Pp The DT_INIT and DT_FINI entries in the dynamic section specify the addresses of the initialization and termination functions, respectively, for @@ -140,8 +150,7 @@ These files are automatically included by .Xr cc 1 and .Xr c++ 1 -in the list of object-code files passed -to +in the list of object-code files passed to .Xr ld 1 when building a shared C or C++ object. .Sh ENVIRONMENT @@ -157,8 +166,8 @@ A colon or space separated list of shared object filenames to be loaded the main program but .Em before its shared object dependencies. -Space is allowed as a separator for backwards compatibility only. Support -may be removed in a future release and should not be relied upon. +Space is allowed as a separator for backwards compatibility only. +Support may be removed in a future release and should not be relied upon. .It Ev LD_BIND_NOW If defined immediate binding of Procedure Link Table (PLT) entries is performed instead of the default lazy method. diff --git a/libexec/lfs_cleanerd/lfs_cleanerd.8 b/libexec/lfs_cleanerd/lfs_cleanerd.8 index a2f4d88caf8..cc90ebccba5 100644 --- a/libexec/lfs_cleanerd/lfs_cleanerd.8 +++ b/libexec/lfs_cleanerd/lfs_cleanerd.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: lfs_cleanerd.8,v 1.11 2002/06/06 01:03:12 perseant Exp $ +.\" $NetBSD: lfs_cleanerd.8,v 1.12 2002/09/29 14:05:54 wiz Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -73,23 +73,26 @@ The following options are available: Use bytes written, rather than segments read, when determining how many segments to clean at once. .It Fl c -Coalescing mode. For each live inode, check to see if it has too many -blocks that are not contiguous, and if it does, rewrite it. After a -single pass through the filesystem the cleaner will exit. +Coalescing mode. +For each live inode, check to see if it has too many +blocks that are not contiguous, and if it does, rewrite it. +After a single pass through the filesystem the cleaner will exit. .It Fl d Run in debug mode. -Do not become a daemon process, and print debugging information. More +Do not become a daemon process, and print debugging information. +More .Fl d s give more detailed debugging information. .It Fl f Use filesystem idle time as the criterion for aggressive cleaning, instead of system load. .It Fl l Ar load-threshhold -Clean more aggressively when the system load is below the given -threshhold. The default threshhold is 0.2. +Clean more aggressively when the system load is below the given threshhold. +The default threshhold is 0.2. .It Fl m Use mmap, rather than rereading the Ifile to update the cleaner's -knowledge of the filesystem. Do not use this option. +knowledge of the filesystem. +Do not use this option. .It Fl n Ar number-of-segments Clean this number of segments at a time: that is, pass this many segments' blocks through a single call to lfs_markv, or, if @@ -103,16 +106,18 @@ Give an efficiency report after every .Ar report-frequency times through the main loop. .It Fl s -When cleaning the file system, send only a few blocks through lfs_markv -at a time. Don't use this option. +When cleaning the file system, +send only a few blocks through lfs_markv at a time. +Don't use this option. .It Fl t Ar timeout Poll the filesystem every .Ar timeout -seconds, looking for opportunities to clean. The default is 300, that -is, five minutes. Note that +seconds, looking for opportunities to clean. +The default is 300, that is, five minutes. +Note that .Nm -will be automatically awakened when the filesystem is active, so it is -not usually necessary to set +will be automatically awakened when the filesystem is active, +so it is not usually necessary to set .Ar timeout to a low value. .El diff --git a/libexec/rpc.rstatd/rpc.rstatd.8 b/libexec/rpc.rstatd/rpc.rstatd.8 index 025db77de9b..a7f36c094ba 100644 --- a/libexec/rpc.rstatd/rpc.rstatd.8 +++ b/libexec/rpc.rstatd/rpc.rstatd.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: rpc.rstatd.8,v 1.11 2002/01/15 02:26:48 wiz Exp $ +.\" $NetBSD: rpc.rstatd.8,v 1.12 2002/09/29 14:05:54 wiz Exp $ .\" .\" Copyright (c) 1985, 1991 The Regents of the University of California. .\" All rights reserved. @@ -56,8 +56,9 @@ The .Ar interval argument specifies the number of seconds that .Nm -should stay active, updating its internal statistics every -second. If no value is specified, 20 seconds will be used. After +should stay active, updating its internal statistics every second. +If no value is specified, 20 seconds will be used. +After .Ar interval seconds with no new RPC requests, if @@ -65,7 +66,8 @@ if was invoked from .Xr inetd 8 , .Nm -exits. Otherwise, +exits. +Otherwise, .Nm loops, becoming dormant until it receives a new RPC request, and staying active until diff --git a/libexec/rpc.rwalld/rpc.rwalld.8 b/libexec/rpc.rwalld/rpc.rwalld.8 index 8a7bf1fb9e9..6f88a1b60a8 100644 --- a/libexec/rpc.rwalld/rpc.rwalld.8 +++ b/libexec/rpc.rwalld/rpc.rwalld.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: rpc.rwalld.8,v 1.8 2002/01/15 02:27:15 wiz Exp $ +.\" $NetBSD: rpc.rwalld.8,v 1.9 2002/09/29 14:05:55 wiz Exp $ .\" .\" Copyright (c) 1985, 1991 The Regents of the University of California. .\" All rights reserved. @@ -43,8 +43,8 @@ .Sh DESCRIPTION .Nm is a server which will send a message to users -currently logged in to the system. This server -invokes the +currently logged in to the system. +This server invokes the .Xr wall 1 command to actually write the messages to the system. diff --git a/libexec/rshd/rshd.8 b/libexec/rshd/rshd.8 index b17a7ab1878..501f7438a61 100644 --- a/libexec/rshd/rshd.8 +++ b/libexec/rshd/rshd.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: rshd.8,v 1.12 2002/02/08 01:30:08 ross Exp $ +.\" $NetBSD: rshd.8,v 1.13 2002/09/29 14:05:55 wiz Exp $ .\" .\" Copyright (c) 1983, 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,18 +45,17 @@ .Sh DESCRIPTION The .Nm -server -is the server for the +server is the server for the .Xr rcmd 3 routine and, consequently, for the .Xr rsh 1 -program. The server provides remote execution facilities +program. +The server provides remote execution facilities with authentication based on privileged port numbers from trusted hosts. .Pp The .Nm -server -listens for service requests at the port indicated in +server listens for service requests at the port indicated in the ``cmd'' service specification; see .Xr services 5 . When a service request is received the following protocol @@ -68,8 +67,8 @@ If the port is not in the range 512-1023, the server aborts the connection. .It The server reads characters from the socket up -to a null (`\e0') byte. The resultant string is -interpreted as an +to a null (`\e0') byte. +The resultant string is interpreted as an .Tn ASCII number, base 10. .It @@ -78,7 +77,8 @@ it is interpreted as the port number of a secondary stream to be used for the .Em stderr . A second connection is then created to the specified -port on the client's machine. The source port of this +port on the client's machine. +The source port of this second connection is also in the range 512-1023. .It The server checks the client's source address @@ -90,8 +90,7 @@ and If the hostname cannot be determined, the dot-notation representation of the host address is used. If the hostname is in the same domain as the server (according to -the last two components of the domain name), -or if the +the last two components of the domain name), or if the .Fl a option is given, the addresses for the hostname are requested, @@ -100,21 +99,21 @@ If address verification fails, the connection is aborted with the message, ``Host address mismatch.'' .It A null terminated user name of at most 16 characters -is retrieved on the initial socket. This user name -is interpreted as the user identity on the +is retrieved on the initial socket. +This user name is interpreted as the user identity on the .Em client Ns 's machine. .It A null terminated user name of at most 16 characters -is retrieved on the initial socket. This user name -is interpreted as a user identity to use on the +is retrieved on the initial socket. +This user name is interpreted as a user identity to use on the .Sy server Ns 's machine. .It A null terminated command to be passed to a -shell is retrieved on the initial socket. The length of -the command is limited by the upper bound on the size of -the system's argument list. +shell is retrieved on the initial socket. +The length of the command is limited by the upper +bound on the size of the system's argument list. .It .Nm then validates the user using @@ -123,7 +122,8 @@ which uses the file .Pa /etc/hosts.equiv and the .Pa .rhosts -file found in the user's home directory. The +file found in the user's home directory. +The .Fl l option prevents .Xr ruserok 3 @@ -137,9 +137,8 @@ the connection is closed. .It A null byte is returned on the initial socket and the command line is passed to the normal login -shell of the user. The -shell inherits the network connections established -by +shell of the user. +The shell inherits the network connections established by .Nm "" . .El .Pp @@ -191,8 +190,8 @@ A .Xr fork 2 by the server failed. .It Sy \*[Lt]shellname\*[Gt]: ... -The user's login shell could not be started. This message is returned -on the connection associated with the +The user's login shell could not be started. +This message is returned on the connection associated with the .Em stderr , and is not preceded by a flag byte. .El @@ -203,8 +202,8 @@ and is not preceded by a flag byte. .Xr login.conf 5 .Sh BUGS The authentication procedure used here assumes the integrity -of each client machine and the connecting medium. This is -insecure, but is useful in an ``open'' environment. +of each client machine and the connecting medium. +This is insecure, but is useful in an ``open'' environment. .Pp A facility to allow all data exchanges to be encrypted should be present. @@ -214,8 +213,8 @@ A more extensible protocol (such as Telnet) should be used. .Nm intentionally rejects accesses from IPv4 mapped address on top of .Dv AF_INET6 -socket, since IPv4 mapped address complicates host-address based -authentication. +socket, since IPv4 mapped address complicates +host-address based authentication. If you would like to accept connections from IPv4 peers, you will need to run .Nm on top of diff --git a/libexec/telnetd/telnetd.8 b/libexec/telnetd/telnetd.8 index 8237a4e345e..8ae6272cd4f 100644 --- a/libexec/telnetd/telnetd.8 +++ b/libexec/telnetd/telnetd.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: telnetd.8,v 1.23 2002/01/15 02:28:22 wiz Exp $ +.\" $NetBSD: telnetd.8,v 1.24 2002/09/29 14:05:55 wiz Exp $ .\" .\" Copyright (c) 1983, 1993 .\" The Regents of the University of California. All rights reserved. @@ -182,7 +182,8 @@ option may be used to enable encryption debugging code. Specifies which entry from .Pa /etc/gettytab should be used to get banner strings, login program and -other information. The default entry is +other information. +The default entry is .Dv default . .It Fl h Disables the printing of host-specific information before @@ -190,18 +191,17 @@ login has been completed. .It Fl k This option is only useful if .Nm -has been compiled with both linemode and kludge linemode -support. If the +has been compiled with both linemode and kludge linemode support. +If the .Fl k -option is specified, then if the remote client does not -support the +option is specified, +then if the remote client does not support the .Dv LINEMODE option, then .Nm will operate in character at a time mode. It will still support kludge linemode, but will only -go into kludge linemode if the remote client requests -it. +go into kludge linemode if the remote client requests it. (This is done by by the client sending .Dv DONT SUPPRESS-GO-AHEAD and @@ -216,8 +216,8 @@ in response to a .Dv DO TIMING-MARK ) for kludge linemode support. .It Fl l -Specifies line mode. Tries to force clients to use line- -at-a-time mode. +Specifies line mode. +Tries to force clients to use line-at-a-time mode. If the .Dv LINEMODE option is not supported, it will go @@ -225,7 +225,8 @@ into kludge linemode. .It Fl n Disable .Dv TCP -keep-alives. Normally +keep-alives. +Normally .Nm enables the .Tn TCP @@ -239,17 +240,19 @@ This option is only enabled when .Nm is compiled for .Dv UNICOS . -It specifies an inclusive range of pseudo-terminal devices to -use. If the system has sysconf variable +It specifies an inclusive range of pseudo-terminal devices to use. +If the system has sysconf variable .Dv _SC_CRAY_NPTY configured, the default pty search range is 0 to .Dv _SC_CRAY_NPTY ; -otherwise, the default range is 0 to 128. Either +otherwise, the default range is 0 to 128. +Either .Ar lowpty or .Ar highpty may be omitted to allow changing -either end of the search range. If +either end of the search range. +If .Ar lowpty is omitted, the - character is still required so that .Nm @@ -269,8 +272,7 @@ and thus is only useful if .Xr login 1 supports the .Fl s -flag to indicate that only -Kerberos or S/Key +flag to indicate that only Kerberos or S/Key validated logins are allowed, and is usually useful for controlling remote logins from outside of a firewall. @@ -308,8 +310,7 @@ file. This option causes .Nm to refuse connections from addresses that -cannot be mapped back into a symbolic name -via the +cannot be mapped back into a symbolic name via the .Xr gethostbyaddr 3 routine. .It Fl X Ar authtype @@ -318,8 +319,7 @@ This option is only valid if has been built with support for the authentication option. It disables the use of .Ar authtype -authentication, and -can be used to temporarily disable +authentication, and can be used to temporarily disable a specific authentication type without having to recompile .Nm "" . .It Fl 4 @@ -360,8 +360,7 @@ session is started up, sends .Tn TELNET options to the client side indicating -a willingness to do the -following +a willingness to do the following .Tn TELNET options, which are described in more detail below: .Bd -literal -offset indent @@ -445,8 +444,7 @@ session is shut down. Only sent if .Nm is compiled with support for data encryption, and -indicates a willingness to decrypt -the data stream. +indicates a willingness to decrypt the data stream. .El .Pp .Nm @@ -510,8 +508,7 @@ kludge linemode, and the client responded with .Dv WONT LINEMODE . If the client responds with .Dv WILL TM , -the it is assumed that the client supports -kludge linemode. +the it is assumed that the client supports kludge linemode. Note that the .Op Fl k option can be used to disable this. @@ -525,8 +522,7 @@ information for automatic login. Only sent if .Nm is compiled with support for data encryption, and -indicates a willingness to decrypt -the data stream. +indicates a willingness to decrypt the data stream. .El .Pp At the end of a login session, |
