ux_to_aa(1M)             DG/UX B2 Security R4.12MU02            ux_to_aa(1M)


NAME
       uxtoaa - add standard password and group entries to trusted A&A
       database

SYNOPSIS
       uxtoaa  [-v] [-u user] [-g group] passwdfile groupfile

   where:
       user        A username; default = proto
       group       A group name; default = general
       passwdfile  A source password file in the format of /etc/passwd
       groupfile   The source group file in the format of /etc/group

DESCRIPTION
       The uxtoaa command adds entries from traditional DG/UX /etc/passwd
       and /etc/group format files to the DG/UX Trusted Authentication and
       Authorization (A&A) database.

   Options
       -v     Write to standard output the user names being processed.  (The
              group names are not written to standard output.)

       -u     Specify which user account in the existing A&A database to use
              as a model when converting user entries from passwdfile.

       -g     Specify which group in the existing A&A database to use as a
              model when converting group entries group groupfile.

EXAMPLES
       $ su
       # authck
       # cp /etc/passwd /etc/passwd.saved
       # cp /etc/group /etc/group.saved
       # uxtoaa -u modeluser -g modelgroup /etc/passwd /etc/group
       # authck

FILES
       /etc/passwd
       /etc/group

DIAGNOSTICS
       uxtoaa writes all diagnostic and statistical messages to standard
       error.

       uxtoaa exits with one of the following values:

       0    uxtoaa has successfully added all user and group entries from
            the source files to the Trusted A&A database.

       255  uxtoaa has been invoked incorrectly (usage error) or there is
            at least one erroneous group or user entry.

SEE ALSO
       aaupdate(1M), authck(1M), group(4), passwd(4).

NOTES
       If you are trying to add the /etc/passwd and /etc/group files to the
       A&A database, save them before running uxtoaa.

       As uxtoaa exits at the first error it encounters, run authck(1M)
       first to verify that uxtoaa has a valid pre-existing A&A database
       to add to.

       Uxtoaa processes groups before users.  If uxtoaa fails while
       processing the groupfile, you must edit the groupfile to remove the
       entries uxtoaa cannot process.

       Similarly with processing the passwdfile, uxtoaa will fail at the
       first user it cannot process.  In this case, too, you must edit the
       passwdfile to remove the entries uxtoaa cannot process.

       Uxtoaa reports duplicate group and user ids and always keeps the
       entry in the pre-existing A&A database.

       Always run authck(1M) after uxtoaa successfully completes.

       Uxtoaa only processes the entries in the specified source files.
       If you want to include groups and users from the NIS domain, do the
       following:
              $ su
              # ypcat group > domain.group
              # ypcat passwd > domain.passwd
              # vi domain.passwd
              # vi domain.group
              # authck
              # uxtoaa domain.passwd domain.group
              # authck


Licensed material--property of copyright holder(s)