← Back to branch summary

~ubuntu-branches/ubuntu/utopic/gridengine/utopic

« back to all changes in this revision

Viewing changes to doc/htmlman/htmlman5/share_tree.html

  • Committer: Bazaar Package Importer
  • Author(s): Mark Hymers
  • Date: 2008-06-25 22:36:13 UTC
  • Revision ID: james.westby@ubuntu.com-20080625223613-tvd9xlhuoct9kyhm
Tags: upstream-6.2~beta2
Import upstream version 6.2~beta2

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/htmlman/htmlman5/share_tree.html
 
1
<HTML>
 
2
<BODY BGCOLOR=white>
 
3
<PRE>
 
4
<!-- Manpage converted by man2html 3.0.1 -->
 
5
NAME
 
6
     share_tree - Grid Engine share tree file format
 
7
 
 
8
DESCRIPTION
 
9
     The share tree defines the long-term  resource  entitlements
 
10
     of  users/projects  and  of  a hierarchy of arbitrary groups
 
11
     thereof.
 
12
 
 
13
     The current share tree can be  displayed  via  the  <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>
 
14
     -sstree  option.  The  output  follows the <I>share</I>_<I>tree</I> format
 
15
     description. A share tree can be created and an existing can
 
16
     be modified via the -astree and -mstree options to <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>.
 
17
     Individual  share  tree  nodes  can  be  created,  modified,
 
18
     deleted,  or shown via the -astnode, -dstnode, -mstnode, and
 
19
     -sstnode options to <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>.
 
20
 
 
21
FORMAT
 
22
     The format of a share tree file is defined as follows:
 
23
 
 
24
     <B>o</B>  A new node starts with the attribute id, and  equal  sign
 
25
        and  the  numeric  identification  number  of  the  node.
 
26
        Further attributes of that node follow until another  id-
 
27
        keyword is encountered.
 
28
 
 
29
     <B>o</B>  The attribute childnodes contains a comma separated  list
 
30
        of child nodes to this node.
 
31
 
 
32
     <B>o</B>  The parameter name refers to an arbitrary  name  for  the
 
33
        node  or to a corresponding user (see <B><A HREF="../htmlman5/user.html">user(5)</A></B>) or project
 
34
        (see <B><A HREF="../htmlman5/project.html">project(5)</A></B>) if the node is a leaf node of the  share
 
35
        tree. The name for the root node of the tree is "Root" by
 
36
        convention.
 
37
 
 
38
     <B>o</B>  The parameter shares defines the share of the node  among
 
39
        the nodes with the same parent node.
 
40
 
 
41
     <B>o</B>  A user leaf node named 'default' can be defined as a des-
 
42
        cendant  of  a  <B><A HREF="../htmlman5/project.html">project(5)</A></B>)  node  in the share tree. The
 
43
        default node defines the number of shares for users   who
 
44
        are  running  in  the project, but who do not have a user
 
45
        node defined under the project. The default user node  is
 
46
        a  convenient  way  of  specifying  a single node for all
 
47
        users which should receive an equal share of the  project
 
48
        resources. The default node may be specified by itself or
 
49
        with other <B><A HREF="../htmlman5/user.html">user(5)</A></B>) nodes at the same level below a  pro-
 
50
        ject.  All  users, whether explicitly specified as a user
 
51
        node or those which map to the 'default' user  node  must
 
52
        have  a corresponding <B><A HREF="../htmlman5/user.html">user(5)</A></B>) object defined in order to
 
53
        get shares. Do not  configure  a  <B><A HREF="../htmlman5/user.html">user(5)</A></B>)  object  named
 
54
        'default'.
 
55
 
 
56
 
 
57
SEE ALSO
 
58
     <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>, <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>, <B><A HREF="../htmlman5/project.html">project(5)</A></B>, <B><A HREF="../htmlman5/user.html">user(5)</A></B>.
 
59
 
 
60
COPYRIGHT
 
61
     See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and  permis-
 
62
     sions.
 
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
</PRE>
 
110
<HR>
 
111
<ADDRESS>
 
112
Man(1) output converted with
 
113
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
 
114
</ADDRESS>
 
115
</BODY>
 
116
</HTML>