1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116
|
<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
share_tree - Sun Grid Engine share tree file format
DESCRIPTION
The share tree defines the long-term resource entitlements
of users/projects and of a hierarchy of arbitrary groups
thereof.
The current share tree can be displayed via the <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>
-sstree option. The output follows the <I>share</I>_<I>tree</I> format
description. A share tree can be created and an existing can
be modified via the -astree and -mstree options to <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>.
The -sst option shows a formatted share tree (tree view).
Individual share tree nodes can be created, modified,
deleted, or shown via the -astnode, -dstnode, -mstnode, and
-sstnode options to <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>.
Note, Sun Grid Engine allows backslashes (\) be used to
escape newline (\newline) characters. The backslash and the
newline are replaced with a space (" ") character before any
interpretation.
FORMAT
The format of a share tree file is defined as follows:
<B>o</B> A new node starts with the attribute id, and equal sign
and the numeric identification number of the node.
Further attributes of that node follow until another id-
keyword is encountered.
<B>o</B> The attribute type defines, if a sharetree node refer-
ences a user (type=0), or a project (type=1)
<B>o</B> The attribute childnodes contains a comma separated list
of child nodes to this node.
<B>o</B> The parameter name refers to an arbitrary name for the
node or to a corresponding user (see <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>) or project
(see <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B>) if the node is a leaf node of the share
tree. The name for the root node of the tree is "Root" by
convention.
<B>o</B> The parameter shares defines the share of the node among
the nodes with the same parent node.
<B>o</B> A user leaf node named 'default' can be defined as a des-
cendant of a <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B>) 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 <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>) nodes at the same level below a pro-
ject. All users, whether explicitly specified as a user
node or those which map to the 'default' user node must
have a corresponding <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>) object defined in order to
get shares. Do not configure a <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>) object named
'default'.
EXAMPLES
Jobs of projects P1 and P2 get 50 shares, all other jobs get
10 shares.
id=0
name=Root
type=0
shares=1
childnodes=1,2,3
id=1
name=P1
type=1
shares=50
childnodes=NONE
id=2
name=P2
type=1
shares=50
childnodes=NONE
id=3
name=default
type=0
shares=10
childnodes=NONE
SEE ALSO
<B><A HREF="../htmlman1/sge_intro.html?pathrev=V62u5_TAG">sge_intro(1)</A></B>, <B><A HREF="../htmlman1/qconf.html?pathrev=V62u5_TAG">qconf(1)</A></B>, <B><A HREF="../htmlman5/project.html?pathrev=V62u5_TAG">project(5)</A></B>, <B><A HREF="../htmlman5/user.html?pathrev=V62u5_TAG">user(5)</A></B>.
COPYRIGHT
See <B><A HREF="../htmlman1/sge_intro.html?pathrev=V62u5_TAG">sge_intro(1)</A></B> for a full statement of rights and permis-
sions.
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
|