=pod

=head1 NAME

B<mapsid> - Map sensor name to sensor number or vice versa

=head1 SYNOPSIS

  mapsid [--site-config-file=FILENAME] [--print-classes]
        [{ <sensor-name> | <sensor-number> } ...]

=head1 DESCRIPTION

B<mapsid> is a utility that maps sensor names to sensor numbers or
vice versa depending on the input arguments.  When no arguments are
given, the mapping of all sensor numbers to names is printed.  When a
numeric argument is given, the number to name mapping is printed for
the specified argument.  When a name is given, its numeric id is
printed.  For convenience when typing in sensor names, the case is
irrelevant.


=head1 OPTIONS

Option names may be abbreviated if the abbreviation is unique or is an
exact match for an option.  A parameter to an option may be specified
as B<--arg>=I<param> or B<--arg> I<param>, though the first form is
required for options that take optional parameters.

=over 4

=item B<--print-classes>

For each sensor, print the classes for which the sensor collects data.

=item B<--site-config-file>=I<FILENAME>

Read the SiLK site configuration from the named file I<FILENAME>.
When this switch is not provided, the location specified by the
C<$SILK_CONFIG_FILE> environment variable is used if that variable is
not empty.  The value of C<$SILK_CONFIG_FILE> should include the name
of the file.  Otherwise, the application looks for a file named
F<silk.conf> in the following directories: the directory specified in
the F<$SILK_DATA_ROOTDIR> environment variable; the data root
directory that is compliled into SiLK (use the B<--version> switch to
view this value); the directories F<$SILK_PATH/share/silk/>,
F<$SILK_PATH/share/>, or F<$SILK_PATH>; or in the F<share/silk/> and
F<share/> directories parallel to the application's directory.

=back


=head1 EXAMPLES

Name to number mapping:

 $ mapsid beta
 BETA -> 1

Number to name mapping:

 $ mapsid 3
 3 -> DELTA

Print all mappings:

 $ mapsid
  0 -> ALPHA
  1 -> BETA
  2 -> GAMMA
  3 -> DELTA
  4 -> EPSLN
  5 -> ZETA
      ....

=head1 SEE ALSO

B<rwfilter(1)>, B<rwcut(1)>

=cut

$SiLK: mapsid.pod 6638 2007-03-12 21:44:49Z mthomas $

Local variables:
mode:text
indent-tabs-mode:nil
End: