nc hosts

nc: Usage Message

NC HOSTS
    Show taskers that are currently in the cluster along with tasker metadata.

    The default output includes:
    NAME LOAD STATUS RUN/SUSP SLOTS HEARTBEAT RESERVATIONS MESSAGE

    Each tasker takes on the name of its host by default.

    The "RUN/SUSP" column shows running jobs and suspended jobs,
    respectively.

    The "SLOTS" column shows total job slots.

    The heartbeat is the age of the most recent heartbeat received by the
    vovserver for that specific tasker.

    The reservations column shows shorthand representations for who or what
    the tasker is reserved and the time remaining for the reservation. The
    shorthand format is TYPE:NAME, where TYPE is one of:
    G (group), I (ID), B (bucket), C (jobclass), P (project), or U (user).

USAGE:
    % nc hosts [OPTIONS]

OPTIONS:
    -a              -- Show all known hosts (used with -m).
    -ALL            -- Show resources for each tasker.
    -c              -- Show consumable resources (e.g. RAM and CPUs).
    -f              -- Show list of tasker fields.
    -h              -- Help usage message.
    -hw <HW>        -- Show only taskers that match HW constraints.
    -INFO           -- Same as -O ...fields about host, arch, model, ...
    -LOAD           -- Same as -O ...selection of fields about load...
    -m              -- Show machine parameters (RAM, CPUfreq, ...)
    -O <fmt>        -- Specify output format. The format string can contain
                       elements like @FIELDNAME@ or @FIELDNAME:WIDTH@ where
                       a negative width means left-align and a positive width
                       means right-align.
    -r              -- Show status and resources for each tasker.
    -rl             -- Show resources (legacy: pre-2013.03 format).
    -RAM            -- Same as -O "@NAME@ RAM/@RAM@ RAMFREE#@RAMFREE@
                                   RAMTOTAL#@RAMTOTAL@"
    -rule <SELRULE> -- Show only taskers that match the given selection rule.
                       Use "vovselect fieldname from taskers" for the complete
                       list of fields that can be used in the rule.
                       Example rules:
                            "status==READY"
                            "status!=OVRLD slots>8"
                       Can accept multiple constraints.
    -SLOTS          -- Same as -O "@NAME@ SLOTS/@SLOTS@ SLOTSTOTAL#@SLOTSTOTAL@
                                   CORES/@CORES@ CORESTOTAL#@CORESTOTAL@"
    -slowdown       -- Used only for testing.

EXAMPLES:
    % nc hosts
    % nc hosts -m
    % nc hosts -a -m
    % nc hosts -hw 'RAMTOTAL>18000'
    % nc hosts -f
    % nc hosts -O "RAMFREE#@RAMFREE@ SWAP/@SWAP@ M=@MODEL@"
    % nc hosts -O "@I:4@ @NAME:-14@ @STATUS:-8@ @HOST@ "
    % nc hosts -RAM
    % nc hosts -hw 'RAMTOTAL>18000' -RAM
    % nc hosts -ALL | grep -A8 ^lnx001
    % nc hosts -rule "cores>4 ramtotal<20000" -O "@name@ @corestotal@"