GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MAPSID (1)

.ds Aq ’

NAME

mapsid - Map between sensor names and sensor numbers

CONTENTS

SYNOPSIS



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

  mapsid --help

  mapsid --version



DESCRIPTION

As of SiLK 3.0, mapsid is deprecated, and it will be removed in the SiLK 4.0 release. Use rwsiteinfo(1) instead---the EXAMPLES section shows how to use rwsiteinfo to get output similar to that produced by mapsid.

mapsid is a utility that maps sensor names to sensor numbers or vice versa depending on the input arguments. Sensors are defined in the silk.conf(5) file.

When no sensor arguments are given to mapsid, 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, case is ignored.

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 --arg=param or --arg param, though the first form is required for options that take optional parameters.
--print-classes For each sensor, print the classes for which the sensor collects data. The classes are enclosed in square brackets, [].
--print-descriptions For each sensor, print the description of the sensor as defined in the silk.conf file (if any).
--site-config-file=FILENAME Read the SiLK site configuration from the named file FILENAME. When this switch is not provided, mapsid searches for the site configuration file in the locations specified in the FILES section.
--help Print the available options and exit.
--version Print the version number and information about how SiLK was configured, then exit the application.

EXAMPLES

The following examples demonstrate the use of mapsid. In addition, each example shows how to get similar output using rwsiteinfo(1).

In the following examples, the dollar sign ($) represents the shell prompt. The text after the dollar sign represents the command line. Lines have been wrapped for improved readability, and the back slash (\) is used to indicate a wrapped line.

    Name to number mapping



 $ mapsid beta
 BETA ->     1

 $ rwsiteinfo --fields=sensor,id-sensor --sensors=BETA
 Sensor|Sensor-ID|
   BETA|        1|



Unlike mapsid, matching of the sensor name is case-sensitive in rwsiteinfo.

    Number to name mapping



 $ mapsid 3
     3 -> DELTA

 $ rwsiteinfo --fields=id-sensor,sensor --sensors=3 --delimited=,
 Sensor-ID,Sensor
 3,DELTA



    Print all mappings



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

 $ rwsiteinfo --fields=id-sensor,sensor --no-titles
   0| ALPHA|
   1|  BETA|
   2| GAMMA|
   3| DELTA|
   4| EPSLN|
   5|  ZETA|
   ...



    Print the class



 $ mapsid --print-classes 3 ZETA
     3 -> DELTA  [all]
 ZETA  ->     5  [all]

 $ rwsiteinfo --fields=id-sensor,sensor,class:list --sensors=4,ZETA
 Sensor-ID|Sensor|Class:list|
         3| DELTA|       all|
         5|  ZETA|       all|



    Print the class and description



 $ mapsid --print-classes --print-description 0 1
     0 -> ALPHA  [all]  "Primary gateway"
     1 -> BETA   [all]  "Secondary gateway"



rwsiteinfo supports using an integer range when specifying sensors.



 $ rwsiteinfo --fields=id-sensor,sensor,class:list,describe-sensor \
       --sensors=0-1
 Sensor-ID|Sensor|Class:list|Sensor-Description|
         0| ALPHA|       all|   Primary gateway|
         1|  BETA|       all| Secondary gateway|



ENVIRONMENT

SILK_CONFIG_FILE This environment variable is used as the value for the --site-config-file when that switch is not provided.
SILK_DATA_ROOTDIR This environment variable specifies the root directory of data repository. As described in the FILES section, mapsid may use this environment variable when searching for the SiLK site configuration file.
SILK_PATH This environment variable gives the root of the install tree. When searching for configuration files, mapsid may use this environment variable. See the FILES section for details.

FILES

${SILK_CONFIG_FILE}
${SILK_DATA_ROOTDIR}/silk.conf
/data/silk.conf
${SILK_PATH}/share/silk/silk.conf
${SILK_PATH}/share/silk.conf
/usr/local/share/silk/silk.conf
/usr/local/share/silk.conf Possible locations for the SiLK site configuration file which are checked when the --site-config-file switch is not provided.

SEE ALSO

rwsiteinfo(1), silk.conf(5), silk(7)

NOTES

As of SiLK 3.0, mapsid is deprecated; use rwsiteinfo(1) instead.
Search for    or go to Top of page |  Section 1 |  Main Index


SiLK 3.11.0.1 MAPSID (1) 2016-04-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.