1.\" @(#)publickey.3r 2.1 88/08/07 4.0 RPCSRC
|
2.\" $FreeBSD: head/lib/libc/rpc/publickey.3 50476 1999-08-28 00:22:10Z peter $
|
2.\" $FreeBSD: head/lib/libc/rpc/publickey.3 57686 2000-03-02 09:14:21Z sheldonh $ |
3.\" 4.TH PUBLICKEY 3R "6 October 1987" 5.SH NAME 6publickey, getpublickey, getsecretkey \- get public or secret key 7.SH SYNOPSIS 8.nf 9.B #include <rpc/rpc.h> 10.B #include <rpc/key_prot.h> 11.LP 12.B getpublickey(netname, publickey) 13.B char netname[\s-1MAXNETNAMELEN\s0+1]; 14.B char publickey[\s-1HEXKEYBYTES\s0+1]; 15.LP 16.B getsecretkey(netname, secretkey, passwd) 17.B char netname[\s-1MAXNETNAMELEN\s0+1]; 18.B char secretkey[\s-1HEXKEYBYTES\s0+1]; 19.B char *passwd; 20.fi 21.SH DESCRIPTION 22.IX "getpublickey function" "" "\fLgetpublickey()\fP function" 23.IX "getsecretkey function" "" "\fLgetsecretkey()\fP function" 24These routines are used to get public and secret keys from the 25.SM YP 26database. 27.B getsecretkey(\|) 28has an extra argument, 29.IR passwd , 30which is used to decrypt the encrypted secret key stored in the database. 31Both routines return 1 if they are successful in finding the key, 0 otherwise. 32The keys are returned as 33.SM NULL\s0-terminated,
|
34hexadecimal strings. If the password supplied to
|
34hexadecimal strings. 35If the password supplied to |
36.B getsecretkey(\|) 37fails to decrypt the secret key, the routine will return 1 but the 38.I secretkey 39argument will be a 40.SM NULL 41string (``''). 42.SH "SEE ALSO" 43.BR publickey (5) 44.LP 45.I \s-1RPC\s0 Programmer's Manual 46in 47.TX NETP
|