.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "oar_resources_init 1"
.TH oar_resources_init 1 "2016-02-16" "oar_resources_init" "OAR commands"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
oar_resource_init \- Connect to a list of hosts to gather system information and create the corresponding OAR resources.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBoar_resource_init\fR  [options] <hostfile>
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Hosts are read one per line from \fBhostfile\fR (must be readable by user oar) or \s-1STDIN\s0 (if \fBhostfile\fR is \-).
.PP
Every host in \fBhostfile\fR must have the \*(L"oar-node\*(R" service started (the command connects to the hosts via \s-1SSH\s0 on the port 6667).
.PP
The command either generates a script which could be executed afterward, or directly executes the \s-1OAR\s0 commands (oarnodesetting and oarproperty).
.PP
The following \s-1OAR\s0 resource hierarchy is assumed:
.Sp
.RS 4
host > cpu > core
.RE
.PP
Or if the \fB\-T\fR option is set:
.Sp
.RS 4
host > cpu > core > thread
.RE
.PP
The mem property is set along with the hierarchy.
.PP
Other properties are not set, however the generated script can be modified to do so, or the oarnodesetting command can be used to set them afterward.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-H\fR" 4
.IX Item "-H"
Handle HyperThreading. Unless \fB\-T\fR is used, every logical cpus (threads) belonging to a same core will be assigned to the cpuset internal property, separated by commas.
.IP "\fB\-T\fR" 4
.IX Item "-T"
Use the thread property for HyperThreading (imply \-H).
.IP "\fB\-o\fR [file]" 4
.IX Item "-o [file]"
Script filename.
.IP "\fB\-x\fR" 4
.IX Item "-x"
Execute the script at the end and remove it.
.IP "\fB\-y\fR" 4
.IX Item "-y"
Assume \*(L"yes\*(R" as answer to all prompts and run non-interactively.
.IP "\fB\-v\fR" 4
.IX Item "-v"
Print the generated script.
.IP "\fB\-e\fR [path]" 4
.IX Item "-e [path]"
Path to the ssh command.
.IP "\fB\-n\fR [path]" 4
.IX Item "-n [path]"
Path to the oarnodesetting command.
.IP "\fB\-p\fR [path]" 4
.IX Item "-p [path]"
Path to the oarproperty command.
.IP "\fB\-c\fR [path]" 4
.IX Item "-c [path]"
Path to the oar.conf file.
.IP "\fB\-h\fR" 4
.IX Item "-h"
Print the command usage.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIoarnodesetting\fR\|(1), \fIoarproperty\fR\|(1), \fIoar_resources\-add\fR\|(1), \fIoarremoveresource\fR\|(1), \fIbash\fR\|(1)
.SH "COPYRIGHTS"
.IX Header "COPYRIGHTS"
.Vb 1
\& Copyright 2003\-2016 Laboratoire d\*(AqInformatique de Grenoble (http://www.liglab.fr). This software is licensed under the GNU General Public License Version 2 or above. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.Ve