USERSETUP(1) | General Commands Manual | USERSETUP(1)

# NAME

`usersetup` —
initialize the INGRES users file

# SYNOPSIS

`usersetup` | [status [pathname]]

# DESCRIPTION

The `usersetup` utility reads the /etc/passwd file and reformats it to create the INGRES users file, stored in .../files/users. If pathname is specified, it replaces the default prefix. If pathname is “-”, the result is written to the standard output.

The user name, user ID, and group ID are initialized to be identical to the corresponding entry in the /etc/passwd file. The status field is initialized to 000001, except for user “ingres”, which is initialized with all permission bits set. If the status parameter is provided, the status field is set to this value instead.

The “initialization file” parameter is set to the file .ingres in the user's login directory. The user code field is initialized with sequential two-character codes. All other fields are initialized to be null.

After running `usersetup`, the users file must be edited. Any users who are to have special authorizations should have the status field changed according to the users file specification. To disable a user from executing INGRES entirely, remove their line from the users file.

As users are added or deleted from the /etc/passwd file, the users file will need to be edited to reflect the changes. For deleted users, it is only necessary to delete the line for that user. To add a user, assign a unique two-character code and enter a line in the users file in the form:

`name:cc:uid:gid:status:flags:proctab:initfile::databases`

Where:

name
  The user name from /etc/passwd.
cc
  The two-character user code (must be unique).
uid
  The user ID from /etc/passwd.
gid
  The group ID from /etc/passwd.
status
  The status bits (normally 000000).
flags
  Default flags for INGRES on a per-user basis.
proctab
  Default process table (defaults to `=proctab7`).
initfile
  The initialization file.
databases
  A list of databases the user may enter. If null, all databases are accessible. If the first character is a dash, the field is a comma-separated list of databases which may not be entered. Otherwise, it is a list of databases which may be entered. This field also includes the names of databases which may be created.

The `usersetup` utility may be executed only once, to initially create the users file.

# FILES

.../files/users
  INGRES users file.
/etc/passwd
  System password file.

# SEE ALSO

ingres(1), passwd(5)

# BUGS

It should be able to bring the users file up to date incrementally.

# HISTORY

Originally part of UC Berkeley INGRES 8.9 (1988).

March 28, 2026 | NetBSD 10.1_STABLE