dg_getrootkey(2)               DG/UX 5.4R3.00               dg_getrootkey(2)


NAME
       dggetrootkey - get root's secret key

SYNOPSIS
       int  dggetrootkey (secretkey)
       char * secretkey;

   where:
       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(1M) 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
       The process's effective user id must be superuser.

RETURN VALUE
       0      The operation was successful.

       -1     An error occurred.  errno indicates the error.

DIAGNOSTICS
       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
       keyserv(1M), dgdecryptsessionkey(2), dgencryptsessionkey(2),
       dgsetsecretkey(2).





















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