.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'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 >0, 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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "oar_resources_init 1"
.TH oar_resources_init 1 2024-04-10 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 STDIN (if \fBhostfile\fR is \-).
.PP
Every host in \fBhostfile\fR must have the "oar-node" service started (the command connects to the hosts via SSH on the port 6667).
.PP
The command either generates a script which could be executed afterward, or directly executes the OAR commands (oarnodesetting and oarproperty).
.PP
The following OAR 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 "yes" 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"
\&\fBoarnodesetting\fR\|(1), \fBoarproperty\fR\|(1), \fBoar_resources\-add\fR\|(1), \fBoarremoveresource\fR\|(1), \fBbash\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