dggetrootkey(2)           DG/UX 4.30            dggetrootkey(2)



     NAME
          dg_getrootkey - Get root's secret key

     SYNOPSIS
          int dg_getrootkey  (secretkey)
              char *          secretkey;

     PARAMETERS
          secretkey
               The root secret key.

     DESCRIPTION
          This call is used to read the root's decrypted secret key
          from battery backed-up RAM.  It is used by the keyserv(8c)
          process to initialize its database.  In this way, the
          keyserver can get the root key without operator
          intervention, as in the case of a power failure in the
          middle of the night.

     ACCESS CONTROL
          None.

     RETURN VALUE
          0    The operation was successful.

          -1   An error occurred.  Errno indicates the error.

     EXCEPTIONS
          Errno may be set to one of the following error codes:

          EPERM
               The process's effective user id is not superuser.

          EFAULT
               Some part of the string pointed to by secretkey lies
               outside the process's writable address space.

     SEE ALSO
          dg_decryptsessionkey.2, dg_encryptsessionkey.2,
          dg_setsecretkey.2, keyserv(8c).















     Licensed material--property of copyright holder(s)         Page 1