publickey(3R)

NAME

publickey, getpublickey, getsecretkey − get public or secret key

SYNOPSIS

#include <rpc/rpc.h>

#include <rpc/key_prot.h>

getpublickey (netname, publickey)

char netname[MAXNETNAMELEN+1];

char publickey[HEXKEYBYTES+1];

getsecretkey (netname, secretkey, passwd)

char netname[MAXNETNAMELEN+1];

char secretkey[HEXKEYBYTES+1];

char *passwd;

Remarks

The Network Information Service (NIS) was formerly known as Yellow Pages (yp). Although the name has changed, the functionality of the service remains the same.

DESCRIPTION

These routines are used to get public and secret keys from the NIS publickey(4) database.

getsecretkey() has an extra argument, passwd, which is used to decrypt the encrypted secret key stored in the publickey(4) database.

Both routines return 1 if they are successful in finding the key; otherwise, these routines return 0.

The keys are returned as NULL-terminated, hexadecimal strings.

If the password supplied to getsecretkey() fails to decrypt the secret key, the routine will return 1 but the secretkey argument will be a NULL string.

AUTHOR

The publickey routines were developed by Sun Microsystems, Inc.

Museum