summaryrefslogtreecommitdiffstats
path: root/lib/libc/rpc/rpc_secure.3
diff options
context:
space:
mode:
authorsheldonh <sheldonh@FreeBSD.org>2000-03-02 09:14:21 +0000
committersheldonh <sheldonh@FreeBSD.org>2000-03-02 09:14:21 +0000
commit329223e6f229a55ee8fed800f358f30e994ed749 (patch)
tree5d5e6c715ccfb778a29f10e1ea16f06731edbda8 /lib/libc/rpc/rpc_secure.3
parent05f0a865546b5e0b902987be72a75a7b0ef85d09 (diff)
downloadFreeBSD-src-329223e6f229a55ee8fed800f358f30e994ed749.zip
FreeBSD-src-329223e6f229a55ee8fed800f358f30e994ed749.tar.gz
Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
Diffstat (limited to 'lib/libc/rpc/rpc_secure.3')
-rw-r--r--lib/libc/rpc/rpc_secure.345
1 files changed, 30 insertions, 15 deletions
diff --git a/lib/libc/rpc/rpc_secure.3 b/lib/libc/rpc/rpc_secure.3
index 23f1a7e..f3e57cc 100644
--- a/lib/libc/rpc/rpc_secure.3
+++ b/lib/libc/rpc/rpc_secure.3
@@ -69,7 +69,8 @@ The first parameter
.Fa name
is the network name, or
.Fa netname ,
-of the owner of the server process. This field usually
+of the owner of the server process.
+This field usually
represents a
.Fa hostname
derived from the utility routine
@@ -80,21 +81,25 @@ The second field is window on the validity of
the client credential, given in seconds. A small
window is more secure than a large one, but choosing
too small of a window will increase the frequency of
-resynchronizations because of clock drift. The third
+resynchronizations because of clock drift.
+The third
parameter
.Fa addr
is optional. If it is
.Dv NULL ,
then the authentication system will assume
that the local clock is always in sync with the server's
-clock, and will not attempt resynchronizations. If an address
+clock, and will not attempt resynchronizations.
+If an address
is supplied, however, then the system will use the address
for consulting the remote time service whenever
resynchronization
-is required. This parameter is usually the
+is required.
+This parameter is usually the
address of the
.Tn RPC
-server itself. The final parameter
+server itself.
+The final parameter
.Fa ckey
is also optional. If it is
.Dv NULL ,
@@ -113,7 +118,8 @@ is used on the server side for converting a
credential, which is
operating system independent, into a
.Ux
-credential. This routine differs from utility routine
+credential.
+This routine differs from utility routine
.Fn netname2user
in that
.Fn authdes_getucred
@@ -133,11 +139,13 @@ if it fails.
.Pp
.Fn Host2netname
converts from a domain-specific hostname to an
-operating-system independent netname. Returns
+operating-system independent netname.
+Returns
.Dv TRUE
if it succeeds and
.Dv FALSE
-if it fails. Inverse of
+if it fails.
+Inverse of
.Fn netname2host .
.Pp
.Fn Key_decryptsession
@@ -168,7 +176,8 @@ is the inverse of
.Fn key_encryptsession .
.Pp
.Fn Key_encryptsession
-is a keyserver interface routine. It
+is a keyserver interface routine.
+It
takes a server netname and a des key, and encrypts
it using the public key of the the server and the secret key
associated with the effective uid of the calling process. It
@@ -176,7 +185,8 @@ is the inverse of
.Fn key_decryptsession .
.Pp
.Fn Key_gendes
-is a keyserver interface routine. It
+is a keyserver interface routine.
+It
is used to ask the keyserver for a secure conversation key.
Choosing one
.Qq random
@@ -186,14 +196,16 @@ the common ways of choosing random numbers, such as using the
current time, are very easy to guess.
.Pp
.Fn Key_setsecret
-is a keyserver interface routine. It is used to set the key for
+is a keyserver interface routine.
+It is used to set the key for
the effective
.Fa uid
of the calling process.
.Pp
.Fn Netname2host
converts from an operating-system independent netname to a
-domain-specific hostname. Returns
+domain-specific hostname.
+Returns
.Dv TRUE
if it succeeds and
.Dv FALSE
@@ -207,16 +219,19 @@ Returns
.Dv TRUE
if it succeeds and
.Dv FALSE
-if it fails. Inverse of
+if it fails.
+Inverse of
.Fn user2netname .
.Pp
.Fn User2netname
converts from a domain-specific username to an operating-system
-independent netname. Returns
+independent netname.
+Returns
.Dv TRUE
if it succeeds and
.Dv FALSE
-if it fails. Inverse of
+if it fails.
+Inverse of
.Fn netname2user .
.Sh SEE ALSO
.Xr rpc 3 ,
OpenPOWER on IntegriCloud