diff options
author | sheldonh <sheldonh@FreeBSD.org> | 2000-03-02 09:14:21 +0000 |
---|---|---|
committer | sheldonh <sheldonh@FreeBSD.org> | 2000-03-02 09:14:21 +0000 |
commit | 329223e6f229a55ee8fed800f358f30e994ed749 (patch) | |
tree | 5d5e6c715ccfb778a29f10e1ea16f06731edbda8 /lib/libc/rpc/rpc_secure.3 | |
parent | 05f0a865546b5e0b902987be72a75a7b0ef85d09 (diff) | |
download | FreeBSD-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.3 | 45 |
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 , |