Manual Pages for UNIX Operating System command usage for man getpublickey

Networking Services Library Functions          getpublickey(3NSL)



NAME
     getpublickey, getsecretkey, publickey - retrieve  public  or
     secret key

SYNOPSIS
     #include 
     #include 

     int getpublickey(const char netname[MAXNETNAMELEN],
          char publickey[HEXKEYBYTES+1]);


     int getsecretkey(const char netname[MAXNETNAMELEN],
          char secretkey[HEXKEYBYTES+1],const char *passwd);


DESCRIPTION
     The getpublickey() and getsecretkey() functions  get  public
     and  secret  keys  for netname. The key may come from one of
     the following sources:

         o    /etc/publickey file. See publickey(4).

         o    NIS map ``publickey.byname''. The sources and their
              lookup     order     are     specified    in    the
              /etc/nsswitch.conf file. See nsswitch.conf(4).


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

RETURN VALUES
     Both routines return 1 if they are successful in finding the
     key. Otherwise, the 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 [0] will be  set
     to NULL.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:













SunOS 5.11          Last change: 10 Dec 2009                    1






Networking Services Library Functions          getpublickey(3NSL)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     secure_rpc(3NSL),  nsswitch.conf(4),  publickey(4),   attri-
     butes(5)













































SunOS 5.11          Last change: 10 Dec 2009                    2