4.104.114.84.95
Line | |
---|
1 | .\" @(#)publickey.3r 2.1 88/08/07 4.0 RPCSRC |
---|
2 | .\" $FreeBSD: src/lib/libc/rpc/publickey.3,v 1.4 2000/03/02 09:13:46 sheldonh Exp $ |
---|
3 | .\" |
---|
4 | .TH PUBLICKEY 3R "6 October 1987" |
---|
5 | .SH NAME |
---|
6 | publickey, 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" |
---|
24 | These routines are used to get public and secret keys from the |
---|
25 | .SM YP |
---|
26 | database. |
---|
27 | .B getsecretkey(\|) |
---|
28 | has an extra argument, |
---|
29 | .IR passwd , |
---|
30 | which is used to decrypt the encrypted secret key stored in the database. |
---|
31 | Both routines return 1 if they are successful in finding the key, 0 otherwise. |
---|
32 | The keys are returned as |
---|
33 | .SM NULL\s0-terminated, |
---|
34 | hexadecimal strings. |
---|
35 | If the password supplied to |
---|
36 | .B getsecretkey(\|) |
---|
37 | fails to decrypt the secret key, the routine will return 1 but the |
---|
38 | .I secretkey |
---|
39 | argument will be a |
---|
40 | .SM NULL |
---|
41 | string (``''). |
---|
42 | .SH "SEE ALSO" |
---|
43 | .BR publickey (5) |
---|
44 | .LP |
---|
45 | .I \s-1RPC\s0 Programmer's Manual |
---|
46 | in |
---|
47 | .TX NETP |
---|
Note: See
TracBrowser
for help on using the repository browser.