lib/libc/rpc/publickey.3

   1 .\" @(#)publickey.3r    2.1 88/08/07 4.0 RPCSRC
   2 .\" $Id$
   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. If the password supplied to
  35 .B getsecretkey(\|)
  36 fails to decrypt the secret key, the routine will return 1 but the
  37 .I secretkey
  38 argument will be a
  39 .SM NULL
  40 string (``'').
  41 .SH "SEE ALSO"
  42 .BR publickey (5)
  43 .LP
  44 .I \s-1RPC\s0 Programmer's Manual
  45 in
  46 .TX NETP