1997-05-28 05:00:11 +00:00
|
|
|
.\" @(#)publickey.3r 2.1 88/08/07 4.0 RPCSRC
|
1999-08-28 00:22:10 +00:00
|
|
|
.\" $FreeBSD$
|
1999-07-12 20:50:10 +00:00
|
|
|
.\"
|
2001-01-17 18:26:21 +00:00
|
|
|
.Dd October 6, 1987
|
|
|
|
.Dt PUBLICKEY 3
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm publickey , getpublickey , getsecretkey
|
|
|
|
.Nd "get public or secret key"
|
|
|
|
.Sh LIBRARY
|
|
|
|
.Lb librpcsvc
|
|
|
|
.Sh SYNOPSIS
|
2001-10-01 16:09:29 +00:00
|
|
|
.In rpc/rpc.h
|
|
|
|
.In rpc/key_prot.h
|
2001-01-17 18:26:21 +00:00
|
|
|
.Ft int
|
|
|
|
.Fo getpublickey
|
2005-11-23 16:44:23 +00:00
|
|
|
.Fa "const char netname[MAXNETNAMELEN+1]"
|
2001-01-17 18:26:21 +00:00
|
|
|
.Fa "char publickey[HEXKEYBYTES+1]"
|
|
|
|
.Fc
|
|
|
|
.Ft int
|
|
|
|
.Fo getsecretkey
|
|
|
|
.Fa "char netname[MAXNETNAMELEN+1]"
|
|
|
|
.Fa "char secretkey[HEXKEYBYTES+1]"
|
|
|
|
.Fa "char *passwd"
|
|
|
|
.Fc
|
|
|
|
.Sh DESCRIPTION
|
1997-05-28 05:00:11 +00:00
|
|
|
These routines are used to get public and secret keys from the
|
2001-01-17 18:26:21 +00:00
|
|
|
.Tn YP
|
1997-05-28 05:00:11 +00:00
|
|
|
database.
|
2002-12-18 12:45:11 +00:00
|
|
|
The
|
2001-01-17 18:26:21 +00:00
|
|
|
.Fn getsecretkey
|
2002-12-18 12:45:11 +00:00
|
|
|
function
|
1997-05-28 05:00:11 +00:00
|
|
|
has an extra argument,
|
2001-01-17 18:26:21 +00:00
|
|
|
.Fa passwd ,
|
1997-05-28 05:00:11 +00:00
|
|
|
which is used to decrypt the encrypted secret key stored in the database.
|
|
|
|
Both routines return 1 if they are successful in finding the key, 0 otherwise.
|
|
|
|
The keys are returned as
|
2001-01-17 18:26:21 +00:00
|
|
|
.Dv NULL Ns \-terminated ,
|
2000-03-02 09:14:21 +00:00
|
|
|
hexadecimal strings.
|
|
|
|
If the password supplied to
|
2001-01-17 18:26:21 +00:00
|
|
|
.Fn getsecretkey
|
1997-05-28 05:00:11 +00:00
|
|
|
fails to decrypt the secret key, the routine will return 1 but the
|
2001-01-17 18:26:21 +00:00
|
|
|
.Fa secretkey
|
1997-05-28 05:00:11 +00:00
|
|
|
argument will be a
|
2001-01-17 18:26:21 +00:00
|
|
|
.Dv NULL
|
|
|
|
string
|
2010-08-02 13:11:35 +00:00
|
|
|
.Pq Dq \& .
|
2001-01-17 18:26:21 +00:00
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr publickey 5
|
|
|
|
.Pp
|
|
|
|
.%T "RPC Programmer's Manual"
|
1997-05-28 05:00:11 +00:00
|
|
|
in
|
2001-01-17 18:26:21 +00:00
|
|
|
.Pa /usr/share/doc/psd/23.rpc .
|