summaryrefslogtreecommitdiffstats
path: root/usr.bin
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2007-01-15 15:25:15 +0000
committerru <ru@FreeBSD.org>2007-01-15 15:25:15 +0000
commit0a430104078b053650251f158a2c2a1dbf5ebc7e (patch)
tree9ee7a1dbac310ee6f408077129de3e82a024ab8f /usr.bin
parent094d70fac7c91a2d4fa26601007f25c9d46b058e (diff)
downloadFreeBSD-src-0a430104078b053650251f158a2c2a1dbf5ebc7e.zip
FreeBSD-src-0a430104078b053650251f158a2c2a1dbf5ebc7e.tar.gz
Tidy up formatting and some wording.
Diffstat (limited to 'usr.bin')
-rw-r--r--usr.bin/ncplogin/ncplogin.192
-rw-r--r--usr.bin/ncplogin/ncplogout.116
2 files changed, 65 insertions, 43 deletions
diff --git a/usr.bin/ncplogin/ncplogin.1 b/usr.bin/ncplogin/ncplogin.1
index f448526..24b806a 100644
--- a/usr.bin/ncplogin/ncplogin.1
+++ b/usr.bin/ncplogin/ncplogin.1
@@ -45,23 +45,29 @@ server can be created and used independently of the
command.
Connections can be created by any user.
Each user can have multiple
-connections, but each NetWareServer:NetWareUser pair should be unique.
+connections, but each
+.Ar NetWareServer Ns : Ns Ar NetWareUser
+pair should be unique.
.Pp
The
.Nm
command is used to create a permanent connection to a
.Tn NetWare
server.
-Permanent connections will stay connected even if no applications use them.
-This allows users to run different ncp* programs
+Permanent connections will stay open even if no application uses them.
+This allows users to run different
+.Pa ncp*
+programs
without specifying a file server and user to use.
Established connections can be destroyed with the
.Xr ncplogout 1
command.
.Pp
-Upper case options described in this manual
-are common for other ncp* programs and are referred to as
-.Qq connection options .
+Upper case options described in this manual page
+are common for other
+.Pa ncp*
+programs and are referred to as
+.Dq connection options .
Options
.Fl U
and
@@ -70,18 +76,18 @@ are mutually exclusive with the
.No / Ns Ar server Ns : Ns Ar user
syntax.
.Pp
-The options are:
+The following options are available:
.Bl -tag -width indent
.It Fl S Ar server
Specify the name of the
.Tn NetWare
server to connect to.
-This affect only
+This affects only
.Tn IPX
servers.
-For native
+For servers supporting
.Tn IP
-servers, see the
+natively, see the
.Fl A
option.
.It Fl U Ar user
@@ -106,13 +112,19 @@ program accepts this option.
Try to use
.Ar signature_level .
Available values are:
-.Bd -literal -offset indent
-Value Meaning
-0 disable signatures
-1 enable (use if required by server)
-2 request but do not require signing
-3 require signatures
-.Ed
+.Pp
+.Bl -tag -width ".Em Value" -offset indent -compact
+.It Em Value
+.Em Meaning
+.It 0
+disable signatures
+.It 1
+enable (use if required by server)
+.It 2
+request but do not require signing
+.It 3
+require signatures
+.El
.Pp
Note that only packet header signing is implemented.
.It Fl M Ar mode
@@ -120,12 +132,20 @@ Share this connection.
The bits in the
.Ar mode
argument are similar to standard file permissions:
-.Bd -literal -offset indent
-Mask Meaning
-4 READ - connection will be visible.
-2 WRITE - connection can be closed/modified
-1 EXECUTE - user allowed to execute requests.
-.Ed
+.Pp
+.Bl -tag -width ".Em Mask" -offset indent -compact
+.It Em Mask
+.Em Meaning
+.It 4
+.Pq READ
+connection will be visible.
+.It 2
+.Pq WRITE
+connection can be closed/modified.
+.It 1
+.Pq EXECUTE
+user is allowed to execute requests.
+.El
.Pp
By default, the connection is created with
.Ar mode
@@ -139,15 +159,16 @@ This would allow the group to perform
requests,
but not to destroy the connection.
When a server is not explicitly specified,
-ncp* programs try to find a suitable connection in the following order:
+.Pa ncp*
+programs try to find a suitable connection in the following order:
.Bl -enum -offset indent
.It
Try to find a connection owned by the user.
If there is more than one such
connection, try to determine which one is primary.
-The primary flag is set with the
+(The primary flag is set with the
.Fl D
-option.
+option.)
.It
If the primary connection could not be determined,
the first shared connection will be used.
@@ -170,7 +191,7 @@ Specify the
and
.Ar group
attributes for the connection.
-Newly created connections take the
+By default, newly created connections take the
.Ar owner
attribute from the creating user's username and the
.Ar group
@@ -184,7 +205,8 @@ Mark the connection as permanent.
The
.Nm
utility always creates permanent connections.
-This option can be used in other ncp*
+This option can be useful in other
+.Pa ncp*
programs.
.It Fl R Ar retry_count
Specify the number of retries to be performed
@@ -192,14 +214,14 @@ before dropping the connection.
The default value is 10.
.Pp
Note: after a connection is marked
-.Sq BAD ,
+.Dq BAD ,
each request will try to restore it.
This process restores only the
.Tn NCP
connection;
it does not reopen any files that were open
at the time that the connection was marked
-.Sq BAD .
+.Dq BAD .
.It Fl W Ar timeout
Specify the server request timeout in seconds.
The default is 5 seconds.
@@ -212,19 +234,19 @@ and
options.
.El
.Sh IMPLEMENTATION NOTES
-Low level connection management is implemented in the
+Low-level connection management is implemented in the
.Pa ncp.ko
-module.
+kernel module.
The
.Xr IPXrouted 8
program is also required for
.Tn IPX
support.
.Sh FILES
-.Bl -tag -width /var/log/wtmp -compact
+.Bl -tag -width ".Pa ~/.nwfsrc"
.It Pa ~/.nwfsrc
-keeps static parameters for connections and other information
-See
+keeps static parameters for connections and other information;
+see
.Pa /usr/share/examples/nwclient/dot.nwfsrc
for details.
.El
diff --git a/usr.bin/ncplogin/ncplogout.1 b/usr.bin/ncplogin/ncplogout.1
index c228de7..bc220a7 100644
--- a/usr.bin/ncplogin/ncplogout.1
+++ b/usr.bin/ncplogin/ncplogout.1
@@ -7,11 +7,11 @@
.Nd schedule permanent connection to close
.Sh SYNOPSIS
.Nm
-.Op -S Ar server
-.Op -U Ar user
-.Op -c Ar handle
+.Op Fl S Ar server
+.Op Fl U Ar user
+.Op Fl c Ar handle
.Nm
-.Op -c Ar handle
+.Op Fl c Ar handle
.No / Ns Ar server Ns : Ns Ar user
.Sh DESCRIPTION
The
@@ -23,7 +23,8 @@ If the connection is busy (i.e., used by other processes) it will
be closed when the last process using it is terminated.
This command is similar to the
.Tn DOS
-logout.exe command.
+.Pa logout.exe
+command.
.Pp
The options are:
.Bl -tag -width indent
@@ -40,9 +41,8 @@ one connection active.
.It Fl c Ar handle
Close a connection by handle.
A list of available handles can be obtained with the following command:
-.Bd -literal -offset indent
- ncplist c
-.Ed
+.Pp
+.Dl "ncplist c"
.El
.Sh HISTORY
The
OpenPOWER on IntegriCloud