Provided by: echolot_2.1.8-6_all bug

NAME

       pingd - echolot ping daemon

SYNOPSIS

       pingd start
       pingd stop
       pingd process
       pingd add address [address ...]
       pingd delete address [address ...]
       pingd disable address [address ...]
       pingd enable address [address ...]
       pingd set option=value [option=value..] address [address ...]
       pingd setremailercaps capsstring
       pingd deleteremailercaps address
       pingd getkeyconf [address [address ...]]
       pingd sendpings [address [address ...]]
       pingd sendchainpings address:address [address:address ...]
       pingd buildstats
       pingd buildkeys
       pingd buildthesaurus
       pingd buildfromlines
       pingd summary
       pingd dumpconf

DESCRIPTION

       pingd is the heart of echolot. Echolot is a pinger for anonymous
       remailers.

       A Pinger in the context of anonymous remailers is a program that
       regularily sends messages through remailers to check their reliability.
       It then calculates reliability statistics which are used by remailer
       clients to choose the chain of remailers to use.

       Additionally it collects configuration parameters and keys of all
       remailers and offers them in a format readable by remailer clients.

       When called without parameters pingd schedules tasks like sending
       pings, processing incoming mail and requesting remailer-xxx data and
       runs them at configurable intervalls.

COMMANDS

       start
           Start the ping daemon.

       stop
           Send the running pingd process a SIGTERM.

       process
           Sends a HUP signal to the daemon which instructs it to process the
           commands.

           For other effects of sending the HUP Signal see the SIGNALS section
           below.

       add address [address ...]
           Add address to the list of remailers to query for keys and confs.

       delete address [address ...]
           Delete address from the list of remailers to query for keys and
           confs. Delete all statistics and keys for that remailer.

           Note that echolot will add back this remailer if it learns of it
           from other remailers again.  If you do not want that, use the
           disable command.

       disable address [address ...]
           Shorthand for set showit=off pingit=off fetch=off.  This makes
           echolot completely ignore that remailer, until you enable it again.

       enable address [address ...]
           Shorthand for set showit=on pingit=on fetch=on.

       set option=value [option=value..] address [address ...]
           Possible options and values:

           showit={on,off}
               Set showit (show remailer in mlist, rlist etc.) for remailer
               address to either on or off.

           pingit={on,off}
               Set pingit (send out pings to that remailer) for remailer
               address to either on or off.

           fetch={on,off}
               Set fetch (fetch remailer-key and remailer-conf) for remailer
               address to either on or off.

       setremailercaps capsstring
           Some remailers (Mixmaster V2 - currently lcs and passthru2) don’t
           return a useable remailer-conf message. For such remailers you need
           to set it manually.

           For instance:

               ./pingd setremailercaps ’$remailer{"passthru2"} = "<mixer@immd1.informatik.uni-erlangen.de> mix middle";’
               ./pingd setremailercaps ’$remailer{"lcs"} = "<mix@anon.lcs.mit.edu> mix klen1000";’

       deleteremailercaps address
           Delete remailer-conf data for address. The config data will be
           reset from the next valid remailer-conf reply by the remailer.

       getkeyconf [address [address ...]]
           Send a command to immediatly request keys and configuration from
           remailers.  If no addresses are given requests will be sent to all
           remailers.

       sendpings [address [address ...]]
           Send a command to immediatly send pings to the given remailers.  If
           no addresses are given requests will be sent to all remailers.

       sendchainpings address:address [address:address ...]
           Send a command to immediatly send chain pings to the given chains.
           A chain is two remailer addresses seperated by a colon.

       buildstats
           Send a command to immediatly rebuild stats.

       buildkeys
           Send a command to immediatly rebuild the keyrings.

       buildthesaurus
           Send a command to immediatly rebuild the Thesaurus.

       buildfromlines
           Send a command to immediatly rebuild the From Header lines page.

       summary
           Print a status summary of all known addresses to the log (level
           notice).

       dumpconf
           Dumps the current configuration to standard output.

OPTIONS

       --basedir
           The home directory to which everything else is relative. See the
           BASE DIRECTORY section below.

       --verbose
           Verbose mode. Causes pingd to print debugging messages about its
           progress.

       --quiet
           Quiet mode. Be even quieter than normal.

       --help
           Print a short help message and exit sucessfully.

       --version
           Print version number and exit sucessfully.

       --nohup
           Usefull only with the add, set, setremailercaps,
           deleteremailercaps, getkeyconf, sendpings, sendchainpings,
           buildstats, buildkeys, buildthesaurus, buildfromlines, or summary
           command.

           Don’t send a HUP signal to the daemon which instructs it to process
           the commands after adding the command to the task list.

           By default such a signal is sent.

       --process
           Usefull only with the start command.

           Read and process the commands file on startup.

       --detach
           Usefull only with the start command.

           Tell pingd to detach.

BASE DIRECTORY

       The home directory to which everything else is relative.

       Basedir defaults to whatever directory the pingd binary is located. It
       can be overridden by the ECHOLOT_HOME environment variable which in
       turn is weaker than the --basedir setting.

       This directory is then used to locate the configuration file pingd.conf
       (see FILES below).

       The homedir setting in pingd.conf finally sets the base directory.

FILES

       The configuration file is searched in these places in this order:

       the file pointed to by the ECHOLOT_CONF environment variable
       <basedir>/pingd.conf
       $HOME/echolot/pingd.conf
       $HOME/pingd.conf
       $HOME/.pingd.conf
       /etc/echolot/pingd.conf
       /etc/pingd.conf

ENVIRONMENT

       ECHOLOT_CONF echolot config file (see section FILES)
       ECHOLOT_HOME echolot base directory (see section BASE DIRECTORY)

SIGNALS

       On SIGINT, SIGQUIT, and SIGTERM pingd will schedule a shutdown for as
       soon as the current actions are finished or immediatly if no actions
       are currently being processed. It will then write all metadata and
       pingdata to disk and close all files cleanly before exiting.

       On SIGHUP <pingd> will execute any pending commands from the commands
       file (commands.txt by default).  It also closes and reopens the file
       ’output’ which is used for stdout and stderr when the daemon is running
       detached.  This can be used if you want to rotate that file.

AUTHOR

       Peter Palfrader <peter@palfrader.org>

BUGS

       Please report them at
       <URL:http://alioth.debian.org/projects/echolot/<gt>