flux-getrabbit(1)
SYNOPSIS
flux getrabbit [--computes=HOSTS [HOSTS...]] [--jobids=ID [ID...]] [rabbits...]
DESCRIPTION
flux getrabbit provides information about rabbits. It prints RFC 29 Hostlists of rabbits or compute nodes, depending on what arguments are provided. If run with no arguments, all rabbits on the current system are printed in RFC 29 Hostlist format. If the hostnames of one or more rabbits are provided as positional arguments, the compute nodes with PCIe links to those rabbits are printed.
OPTIONS
- -j, --jobids=IDS
List rabbits used by the given Flux job IDs.
If this argument is provided, positional arguments are not accepted.
- -c, --computes=HOSTS
List rabbits with PCIe connections to the given compute nodes. RFC 29 Hostlists of compute nodes are accepted.
If this argument is provided, positional arguments are not accepted.
EXAMPLES
List all rabbits:
$ flux getrabbit
rabbit[1-2]
List the compute nodes attached to rabbit102:
$ flux getrabbit rabbit102
host[16-31]
List the rabbits used by a job:
$ flux getrabbit -j $JOBID
rabbit[1001,1003]
List the rabbits attached to compute nodes:
$ flux getrabbit -c host[1,3,7-15]
rabbit[1001,1003]
PREREQUISITES
This command requires that the rabbit.mapping Flux config key be set to
a path containing a file generated by flux-rabbitmapping(1).