---
name: "sge_user"
section: "5"
platform: "linux"
package: "gridengine-common"
version: "8.1.9+dfsg-13.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sge_user"
---

# sge\_user(5)

Grid Engine user entry file format

## NAME

user - Grid Engine user entry file format

## DESCRIPTION

A user entry is used to store ticket and usage information on a per-user basis. Maintaining user entries for all users participating in a Grid Engine system is required if Grid Engine is operated under a user share tree policy.

If the **enforce\_user** cluster configuration parameter is set to *auto*, a user object for the submitting user will be created automatically during job submission, if one does not already exist. The **auto\_user\_oticket**, **auto\_user\_fshare**, **auto\_user\_default\_project**, and **auto\_user\_delete\_time** cluster configuration parameters will be used as default attributes of the new user object.

A list of currently configured user entries can be displayed via the [*qconf*(1)](/qconf/1.md) **-suserl** option. The contents of each listed user entry can be shown via the **-suser** switch. The output follows the *user* format description. New user entries can be created, and existing ones can be modified, via the **-auser**, **-muser** and **-duser** options to [*qconf*(1)](/qconf/1.md).

Note, Grid Engine allows backslashes (\\) be used to escape newline characters. The backslash and the newline are replaced with a space character before any interpretation.

## FORMAT

A user entry contains four parameters:

### name

The user name in the format for *user\_name* in [*sge\_types*(5)](/sge_types/5.md).

### oticket

The number of override tickets currently assigned to the user.

### fshare

The current functional share of the user.

### default\_project

The default project of the user.

### delete\_time

**Note:** Deprecated, may be removed in future release.\
 The wall-clock time when this user will be deleted, expressed as the number of seconds elapsed since January 1, 1970. If set to zero, the affected user is a permanent user. If set to one, the user currently has active jobs. For additional information about automatically created users, see the **enforce\_user** and **auto\_user\_delete\_time** parameters in  [*sge\_conf*(5)](/sge_conf/5.md).

## SEE ALSO

[*sge\_intro*(1)](/sge_intro/1.md), [*sge\_types*(1)](/sge_types/1.md), [*qconf*(1)](/qconf/1.md). [*sge\_conf*(5)](/sge_conf/5.md).

## COPYRIGHT

See [*sge\_intro*(1)](/sge_intro/1.md) for a full statement of rights and permissions.