HP-UX Software Assistant Reference (November, 2010)

If a user first runs SWA and this file does not exist, a template file is created that contains

instructions on how to use this file. Upon creation, if a ~/.spc_ignore file exists, it is translated

into the SWA format and appended to the template.

You may use ${user_dir} at the beginning of this option. It will be replaced with the value

of the user_dir option (which defaults to $HOME/.swa).

-x inventory_max_age=24

Usage: Intermediate

Applicable steps: inventory

Specifies the age, in hours, of the cached inventory of a given system. If the inventory becomes

too old (based on the timestamp stored in the file), SWA will inventory the host system or depot

again.

Note: There are two special values, 0 and -1. The value of 0 forces an update. The value of

-1 means the file will not be updated, regardless of age.

-x inventory_source=localhost

Usage: Basic

Note: You may only specify one system, depot (limited use cases), or inventory file for analysis

per invocation of SWA. This option is useful for analyzing a remote system without installing

SWA on that system.

Specify one of the following: a host system or depot to be inventoried, analyzed, and reported

on; or an existing inventory file to be analyzed and reported on.

Specify the source as a URL using one of the following formats:

hostname

System specification: uses unauthenticated swlist protocol to gather the host inventory.

[hostname:]full-path-to-depot

Depot specification: also uses swlist protocol.

ssh://[user@]hostname[:full-path-to-depot]

SSH specification to system or depot: uses SSH to contact host and local swlist of the

system or depot.

The inventory information is cached for later access in a cache directory within the

user_dir. The naming of the inventory files is based on the hostname and path-to-depot

as specified (for example, using the fully qualified domain name of a host will be cached

separately from using the node name, even for the same machine). The refresh of the cached

inventory for each inventory_source is determined by the inventory_max_age

option.

Note: This option is equivalent to -s but is suitable for use within an extended options

file (-X) or configuration file.

[file://]full-path-to-inventory-file]

Inventory file specification: must be a local file.

If an argument is specified in such a way that it could be interpreted as either a system

name or a file name, it will be assumed to be a system name. For example, if foo is the

argument, then it will be interpreted as a system named foo. Alternatively, if ./foo is the

argument, then it will be interpreted as an inventory file named foo residing in the current

directory.

If an inventory file name is not specified, the inventory information is cached for later access

in a cache directory within the user_dir. The naming of these cached inventory files is

based on the hostname and path-to-depot as specified (a file using the fully qualified domain

name of a host will be cached separately from one using the node name, even for the same