diet-list -
job listing utility

David Loureiro

2010/02/02

Version 1.1

diet-list can list jobs existing on a machine. This command takes in argument the name of the machine from which we want to get the list of jobs. It's also possible to get the total number of jobs, or the number of jobs in either running or waiting states with the following options: --nball, --nbrun and --nbwait respectively..

Table of Contents

Synopsis

diet-list [--config diet_config_file] --host machine [--nball|--nbrun|--nbwait] [-h] [--help]

Description

diet-list uses the configuration file diet_config_file defined with the --config option to be able to get information about the machine defined with the --host option. If the --config option is not set, diet-list will use $HOME/.diet/client.cfg. If this file does not exist, the path to the client configuration file could also be defined with the DIET_CLIENT_CONFIG environment variable.

Once diet-list has found a DIET architecture, a list of jobs is retrieved and printed on the screen.

By using the --nball option, you get the total number of jobs on the machine instead of the jobs list.

By using the --nbrun option, you get the number of running jobs on the machine instead of the jobs list.

By using the --nbwait option, you get the number of waiting jobs on the machine instead of the jobs list.

[--config diet_config_file]
Configuration file used by diet-list to be able to get the list of jobs from machine. This option can be omitted. In that case we fall back to the default configuration file $HOME/.diet/client.cfg. The configuration file path could also be defined through a environment variable : DIET_CLIENT_CONFIG.
--host machine
Name of the machine we want to get the list of jobs, the total number of jobs or the number of jobs in either running or waiting state.
--nball
The total number of jobs on machine.
--nbrun
The number of running jobs on machine.
--nbwait
The number of waiting jobs on machine.
-h|--help
Some help about diet-list

Files and variables

$HOME/.diet/client.cfg
Default configuration file for diet-list.
DIET_CLIENT_CONFIG
Variable that could tore the path the diet-list configuration file
OMNIORB_CONFIG
Variable defining the path to the omniORB configuration file

Example

How to list the number of jobs on the foo machine?

diet-list --config path_to_the_configuration_file --host foo

How to get the number of jobs on the bar machine?

diet-list --config path_to_the_configuration_file --host bar --nball

How to get the number of running jobs on the foobar machine?

diet-list --config path_to_the_configuration_file --host foobar --nbrun

How to get the number of waiting jobs on the foobar2 machine?

diet-list --config path_to_the_configuration_file --host foobar2 --nbwait

See also

diet-submit(1), diet-cancel(1), diet-agent, omniNames.

Prerequisites

DIET
diet-list requires a DIET installation with version >= 2.3.

Version

Version: 1.1 of 2010/02/02.

License et Copyright

Copyright
© 2010, GRAAL, INRIA Rhône-Alpes, 46 allée d'Italie, 69364 Lyon cedex 07, France tech@sysfera.com

Licence
diet-list Copyright (C) 2010, GRAAL, INRIA Rhône-Alpes - all rights reserved.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Misc
If you find that software interesting, or if you find a bug, please send us a mail : tech@sysfera.com with the description of the problem, the version of the program and/or any information that could help us fixing it.

Author

GRAAL, INRIA Rhône-Alpes
46 allée d'Italie
69364 Lyon cedex 07, FRANCE
Email: tech@sysfera.com
WWW: http://www.sysfera.com.