share_tree - Grid Engine share tree file format
The share tree defines the long-term resource entitlements of users/projects and
of a hierarchy of arbitrary groups thereof. Note that it is normally necessary
to maintain users explicitly to use a share tree, rather than use automatic
creation and (specifically) destruction, or at least set
to 0; see
The current share tree can be displayed via the -sstree
options. The output follows the share_tree
format description. A share
tree can be created and an existing one can be modified via the -astree
options to The -sst
option shows a formatted share
tree (tree view). Individual share tree nodes can be created, modified,
deleted, or shown via the -astnode
Note, Grid Engine allows backslashes (\) be used to escape newline characters.
The backslash and the newline are replaced with a space character before any
The format of a share tree file is defined as follows:
- A new node starts with the attribute id, an equal
sign and the numeric identification number of the node. Further attributes
of that node follow until another id keyword is encountered.
- The attribute type defines whether a sharetree node
references a user (type=0), or a project (type=1).
- The attribute childnodes contains a comma-separated
list of child nodes to this node.
- The parameter name refers to an arbitrary name for
the node, or to a corresponding user (see or project (see if the node is a
leaf node of the share tree. The name of the root node of the tree is
"Root" by convention.
- The parameter shares defines the share of the node
among the nodes with the same parent node.
- A user leaf node named 'default' can be defined as a
descendant of a node in the share tree. The default node defines the
number of shares for users who are running in the project, but who do not
have a user node defined under the project. The default user node is a
convenient way of specifying a single node for all users which should
receive an equal share of the project resources. The default node may be
specified by itself or with other nodes at the same level below a project.
All users, whether explicitly specified as a user node or those which map
to the 'default' user node, must have a corresponding object defined in
order to get shares. Do not configure a object named 'default'.
Jobs of projects P1 and P2 get 50 shares, all other jobs get 10 shares.
See for a full statement of rights and permissions.