HOMEDIR(1)              System General Commands Manual              HOMEDIR(1)

NAME
     homedir - Set home directory automatically for users at first login

SYNOPSIS
     homedir [-cfq] [-u user] [directory]

DESCRIPTION
     The homedir utility is primarily intended to be run automatically when a
     user logs in for the first time to set a home directory if one has not
     already been set.  This is useful for locations that already have a large
     existing user database. It may be run directly from a shell as well. The
     user accounts Administrator (local and domain) and user accounts belong-
     ing to the group Administrators may run homedir directly to assign or
     change the home directory for a user account.  Non-privileged users can
     run this program also but only to print the existing setting for a home
     directory.

     When the utility is run with or without options it will output the user's
     current home directory setting. By default the invoking user's account
     information will be used. However a different user may be specified with
     the '-u' option if the invoking user is privileged enough.

     When invoked for automatic purposes the utility is usually run as:
           homedir -cq directory
     where directory is usually a local directory for local accounts and a
     network directory for network accounts. For network directory accounts to
     be created the Domain Administrator will have to have registered their
     password on the machine being logged into with the regpwd utility.

     The path for directory is recommended for local accounts to be:
           /dev/fs/C/Users/
     and for domain account to be:
           /net/SERVER/c_share/Users/
     because this will provide the best Unix experience and will also align
     with Vista default Win32 directories.

     The following options are available:

     -c      Create the home directory for the user account after setting the
             new path in the user database. The directory will be owned by the
             user with the directory permissions being mode 0600 (read  write
             owner only).

     -f      Force the home directory to be changed even if it currently has a
             setting.  The default action is not to make a change if a setting
             exists.

     -q      Do not output the user's current home directory setting.  Only
             error diagnostics will be printed.

     -u user
             Apply the actions to the specified account user instead of the
             default. The default is to apply actions to the account of the
             user invoking the homedir utility.

EXIT STATUS
     An exit value of 0 indicates success. An exit value >0 indicates an
     error.

SEE ALSO
     regpwd(1), unixpath2win(1), unixpath2win(2), net user

HISTORY
     The homedir utility first appeared for Interix in 2006. It is designed
     and written by Rodney Ruddock.

Interix                         August 17, 2006                        Interix