subsystems_to_roles

The command subsystem_to_roles takes as input a table with a column containing subsystem IDs. The table is extended with an extra column set to roles that make up the subsystems. For each input line (designating a subsystem), a line will be added to the output for each role that occurs in the subsystem.

You can ask for auxiliary roles, but the default is to leave them out. If you want them, use "-aux=1". Example:

subsystems_to_roles [arguments] < input > output

The standard input should be a tab-separated table (i.e., each line is a tab-separated set of fields). Normally, the last field in each line would contain the subsystem name. If another column contains the subsystem, use

-c N

where N is the column (from 1) that contains the subsystem.

This is a pipe command. The input is taken from the standard input, and the output is to the standard output.

Documentation for underlying call

This script is a wrapper for the CDMI-API call subsystems_to_roles. It is documented as follows:

$return = $obj->subsystems_to_roles($subsystems, $aux)

Parameter and return types

$subsystems is a subsystems
$aux is an aux
$return is a reference to a hash where the key is a subsystem and the value is a roles
subsystems is a reference to a list where each element is a subsystem
subsystem is a string
aux is an int
roles is a reference to a list where each element is a role
role is a string

Command-Line Options

-c Column

This is used only if the column containing the subsystem is not the last column.

-i InputFile [ use InputFile, rather than stdin ]

Output Format

The standard output is a tab-delimited file. It consists of the input file with an extra column (Role) added.

Input lines that cannot be extended are written to stderr.