fids_to_subsystem_data [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 identifer. If another column contains the identifier use
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.
This script is a wrapper for the CDMI-API call fids_to_subsystem_data. It is documented as follows:
$return = $obj->fids_to_subsystem_data($fids)
$fids is a fids $return is a reference to a hash where the key is a fid and the value is a ss_var_role_tuples fids is a reference to a list where each element is a fid fid is a string ss_var_role_tuples is a reference to a list where each element is a ss_var_role_tuple ss_var_role_tuple is a reference to a list containing 3 items: 0: a subsystem 1: a variant 2: a role subsystem is a string variant is a string role is a string
This is used only if the column containing the subsystem is not the last column.
The standard output is a tab-delimited file. It consists of the input file with extra columns added.
Input lines that cannot be extended are written to stderr.