=encoding UTF-8

=head1 NAME

oar_resource_init - Connect to a list of hosts to gather system information and create the corresponding OAR resources.

=head1 SYNOPSIS

B<oar_resource_init>  [options] <hostfile>

=head1 DESCRIPTION

Hosts are read one per line from B<hostfile> (must be readable by user oar) or STDIN (if B<hostfile> is -).

Every host in B<hostfile> must have the "oar-node" service started (the command connects to the hosts via SSH on the port 6667).

The command either generates a script which could be executed afterward, or directly executes the OAR commands (oarnodesetting and oarproperty).

The following OAR resource hierarchy is assumed: 

=over

host > cpu > core

=back

Or if the B<-T> option is set:

=over

host > cpu > core > thread

=back

The mem property is set along with the hierarchy.

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.

=head1 OPTIONS

=over 

=item B<-H>

Handle HyperThreading. Unless B<-T> is used, every logical cpus (threads) belonging to a same core will be assigned to the cpuset internal property, separated by commas.

=item B<-T>

Use the thread property for HyperThreading (imply -H).

=item B<-o> [file]

Script filename.

=item B<-x>

Execute the script at the end and remove it.

=item B<-y>

Assume "yes" as answer to all prompts and run non-interactively.

=item B<-v>

Print the generated script.

=item B<-e> [path]

Path to the ssh command.

=item B<-n> [path]

Path to the oarnodesetting command.

=item B<-p> [path]

Path to the oarproperty command.

=item B<-c> [path]

Path to the oar.conf file.

=item B<-h>

Print the command usage.

=back

=head1 SEE ALSO

oarnodesetting(1), oarproperty(1), oar_resources-add(1), oarremoveresource(1), bash(1)

=head1 COPYRIGHTS

 Copyright 2003-2016 Laboratoire d'Informatique 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.

=cut
