1.\" @(#)publickey.3r 2.1 88/08/07 4.0 RPCSRC 2.\" $FreeBSD$ 3.\" 4.Dd October 6, 1987 5.Dt PUBLICKEY 3 6.Os 7.Sh NAME 8.Nm publickey , getpublickey , getsecretkey 9.Nd "get public or secret key" 10.Sh LIBRARY 11.Lb librpcsvc 12.Sh SYNOPSIS 13.In rpc/rpc.h 14.In rpc/key_prot.h 15.Ft int 16.Fo getpublickey 17.Fa "const char netname[MAXNETNAMELEN+1]" 18.Fa "char publickey[HEXKEYBYTES+1]" 19.Fc 20.Ft int 21.Fo getsecretkey 22.Fa "char netname[MAXNETNAMELEN+1]" 23.Fa "char secretkey[HEXKEYBYTES+1]" 24.Fa "char *passwd" 25.Fc 26.Sh DESCRIPTION 27These routines are used to get public and secret keys from the 28.Tn YP 29database. 30The 31.Fn getsecretkey 32function 33has an extra argument, 34.Fa passwd , 35which is used to decrypt the encrypted secret key stored in the database. 36Both routines return 1 if they are successful in finding the key, 0 otherwise. 37The keys are returned as 38.Dv NULL Ns \-terminated , 39hexadecimal strings. 40If the password supplied to 41.Fn getsecretkey 42fails to decrypt the secret key, the routine will return 1 but the 43.Fa secretkey 44argument will be a 45.Dv NULL 46string 47.Pq Dq . 48.Sh SEE ALSO 49.Xr publickey 5 50.Pp 51.%T "RPC Programmer's Manual" 52in 53.Pa /usr/share/doc/psd/23.rpc . 54