1e8636dfdSBill Paul.\" @(#)publickey.3r 2.1 88/08/07 4.0 RPCSRC 27f3dea24SPeter Wemm.\" $FreeBSD$ 3fbc400a6SNik Clayton.\" 41b51e5d0SRuslan Ermilov.Dd October 6, 1987 51b51e5d0SRuslan Ermilov.Dt PUBLICKEY 3 61b51e5d0SRuslan Ermilov.Os 71b51e5d0SRuslan Ermilov.Sh NAME 81b51e5d0SRuslan Ermilov.Nm publickey , getpublickey , getsecretkey 91b51e5d0SRuslan Ermilov.Nd "get public or secret key" 101b51e5d0SRuslan Ermilov.Sh LIBRARY 111b51e5d0SRuslan Ermilov.Lb librpcsvc 121b51e5d0SRuslan Ermilov.Sh SYNOPSIS 131b51e5d0SRuslan Ermilov.Fd "#include <rpc/rpc.h>" 141b51e5d0SRuslan Ermilov.Fd "#include <rpc/key_prot.h>" 151b51e5d0SRuslan Ermilov.Ft int 161b51e5d0SRuslan Ermilov.Fo getpublickey 171b51e5d0SRuslan Ermilov.Fa "char netname[MAXNETNAMELEN+1]" 181b51e5d0SRuslan Ermilov.Fa "char publickey[HEXKEYBYTES+1]" 191b51e5d0SRuslan Ermilov.Fc 201b51e5d0SRuslan Ermilov.Ft int 211b51e5d0SRuslan Ermilov.Fo getsecretkey 221b51e5d0SRuslan Ermilov.Fa "char netname[MAXNETNAMELEN+1]" 231b51e5d0SRuslan Ermilov.Fa "char secretkey[HEXKEYBYTES+1]" 241b51e5d0SRuslan Ermilov.Fa "char *passwd" 251b51e5d0SRuslan Ermilov.Fc 261b51e5d0SRuslan Ermilov.Sh DESCRIPTION 27e8636dfdSBill PaulThese routines are used to get public and secret keys from the 281b51e5d0SRuslan Ermilov.Tn YP 29e8636dfdSBill Pauldatabase. 301b51e5d0SRuslan Ermilov.Fn getsecretkey 31e8636dfdSBill Paulhas an extra argument, 321b51e5d0SRuslan Ermilov.Fa passwd , 33e8636dfdSBill Paulwhich is used to decrypt the encrypted secret key stored in the database. 34e8636dfdSBill PaulBoth routines return 1 if they are successful in finding the key, 0 otherwise. 35e8636dfdSBill PaulThe keys are returned as 361b51e5d0SRuslan Ermilov.Dv NULL Ns \-terminated , 37c6ff3a1bSSheldon Hearnhexadecimal strings. 38c6ff3a1bSSheldon HearnIf the password supplied to 391b51e5d0SRuslan Ermilov.Fn getsecretkey 40e8636dfdSBill Paulfails to decrypt the secret key, the routine will return 1 but the 411b51e5d0SRuslan Ermilov.Fa secretkey 42e8636dfdSBill Paulargument will be a 431b51e5d0SRuslan Ermilov.Dv NULL 441b51e5d0SRuslan Ermilovstring 451b51e5d0SRuslan Ermilov.Pq Dq . 461b51e5d0SRuslan Ermilov.Sh SEE ALSO 471b51e5d0SRuslan Ermilov.Xr publickey 5 481b51e5d0SRuslan Ermilov.Pp 491b51e5d0SRuslan Ermilov.%T "RPC Programmer's Manual" 50e8636dfdSBill Paulin 511b51e5d0SRuslan Ermilov.Pa /usr/share/doc/psd/23.rpc . 52