Provided by: whereami_0.3.34-0.5_all bug

NAME

       whereami  —  non-interatively  ascertain  the location of the computer and reconfigure the
       system appropriately.

SYNOPSIS

       whereami [--debug ]   [--scriptdebug  ]   [--syslog  ]   [--noactions  ]   [--nolocking  ]
       [--mapping  ]   [--basedir  directory  ]  [--statedir directory ]  [--from location_list ]
       [--run_from calling_program_tag ]  [location_list]

DESCRIPTION

       `whereami' provides a  configurable  and  extensible  framework  for  automatic  location-
       detection and reconfiguration of computers, typically laptops.

   Detection
       Detection is handled through the use of various network and hardware probing tools.  These
       tools have been wrapped in small shell scripts to interface them to whereami, but the end-
       user with different requirements may wish to extend these in some situations.

       whereami  processes  the  file /etc/whereami/detect.conf performing the tests specified in
       there in order to decide which location the computer is currently located at.

       For full detail on the discovery process, you should read the detect.conf (5) manpage.

   Configuration
       Configuration is handled through standard shell scripting.  A  variety  of  small  utility
       scripts are provided and the author is always willing to accept more.

       The  file  /etc/whereami/whereami.conf is parsed and a script built containing the actions
       specified there which are associated with the locations found during the detection  phase.
       Actions may be configured for when leaving, remaining, or arriving at a location.

       Once  the  script  has been built, it is run to effect the necessary changes to the system
       configuration.

OPTIONS

       This program follows the modern command-line syntax preceding each option  with  a  double
       dash (`--').  Short form options are also available, but are not documented (RTFC :-)

       --debug   Run in debugging mode.  A verbose output is provided and the resulting script is
                 output to the screen and not executed.

       --scriptdebug
                 Run in script debugging mode.  Each script supplied with `whereami' will `set -o
                 xtrace'  if  the environment variable `DEBUGWHEREAMI' is set to non-blank.  This
                 parameter will set that variable.  The script which is built  by  whereami  will
                 also respond to the environment variable.

       --syslog  Output  some  logging  information  to  syslog.  The 'user' facility is used for
                 this, and it provides an insight into which locations whereami has  chosen,  and
                 why.

                 In  combination  with --scriptdebug above, this can be very useful for debugging
                 your configuration.  Also note that the default installation turns this  on  for
                 apm and init actions.

       --noactions
                 Just  do  the  detection  and  print the location name.  Don't build and run the
                 script from whereami.conf.

                 You might do this if you wanted to use whereami's detection, but  use  something
                 else  for  configuration.   Perhaps  you  could achieve the same end with a very
                 simple whereami.conf, but there should always be two ways to do anything :-).

       --nolocking
                 whereami won't normally let two copies of whereami run at the  same  time.   Use
                 this  option  if  you can come up with a scenario where you should allow this to
                 happen!

       --mapping This will persuade whereami to do only the detection stage, and output a list of
                 the detected locations, suitable for use as a mapping script with ifupdown.

       --hint locations
                 Provides  some  hints  to  the  detection  process.   The  locations set by this
                 parameter  (a  comma-delimited  list)  may  be  referenced  by  rules  in   your
                 detect.conf.

       --basedir directory
                 Specifies  the  base  directory  which  will  contain  both  the detect.conf and
                 whereami.conf.  The default is `/etc/whereami' which should be right for  normal
                 use.

       --statedir directory
                 Specifies  the state directory in which whereami will write files indicating the
                 current and previous locations (iam , iwas) and the script which is run for this
                 environment (whereiam.sh).

       --from location_list
                 Overrides  whereami's  knowledge of where you have come from.  The location_list
                 will be a comma-separated list of the locations which you are leaving.

                 Normally `whereami' maintains a history of locations, so that it knows where you
                 have come from (and what might consequently have to be de-configured) as well as
                 knowing that your location has changed.

       --run_from calling_program_tag
                 This provides a mechanism for calling software, such  as  init  scripts,  pcmcia
                 startup  or  apm  events,  to  pass some of that source information to whereami,
                 where it is promptly ignored, at present.

                 I have a possibly misguided idea that this might be useful somehow, but I  can't
                 think of any application of it at this point!

       location_list
                 Overrides  whereami's  testing  of  where  you are.  The location_list will be a
                 comma-separated list of the locations which you are now at.

                 You might use this if you wished to bypass the detection phase, using some other
                 package to handle that.

SEE ALSO

       detect.conf (5), whereami.conf (5)

       There is some further documentation in HTML available in /usr/share/doc/whereami/manual

FILES

       /etc/whereami/detect.conf
                 Defines the process of detection.

       /etc/whereami/whereami.conf
                 Defines  the  actions  performed  as a result of entering, leaving, or remaining
                 within a particular location.

KNOWN BUGS

       This man page  only  documents  the  current  perl  version  of  whereami.   For  backward
       compatibility  with  people's  setups,  it is possible to configure your system to run the
       older shell-script, which is currently undocumented.

       If you wish to switch from the shell script to the new  perl  program  you  will  need  to
       create  an  appropriate  `detect.conf'  file to define your location detection parameters.
       Your existing whereami.conf file should be compatible with this version.   Once  you  have
       created a detect.conf file in /etc/whereami you should run `dpkg-reconfigure whereami' and
       respond to the questions.

AUTHOR

       This manual page was written by Andrew McMillan <debian@mcmillan.net.nz>  for  the  Debian
       GNU/Linux  system  (but may be used by others).  Permission is granted to copy, distribute
       and/or modify this document under the terms of the GPL version 2.

                                                                                      whereami(8)