Provided by: p10cfgd_1.0-12ubuntu1_all bug
 

NAME

        p10cfgd - remote configuration daemom for Gracilis PackeTen
 

SYNOPSIS

        p10cfgd [IP_PORT]
 

COPYRIGHT

        Copyright (c) 1993 by Colorado Digital Eclectics (CODE)
 
        All rights reserved.
 

DESCRIPTION

        Rmtcfgd is a server program used to send configuration files to a  Gra‐
        cilis PackeTen.  It can be run in background or it can be run by inetd.
        If p10cfgd is to be run by inetd, add the following line  to  /etc/ser‐
        vices
 
        rmtcfg    1236/tcp  # Remote Configuration of PackeTen
 
        and add the following to /etc/inetd.conf
 
        # Remote configuration service for PackeTen
        rmtcfg  stream  tcp  nowait  root  /usr/bin/p10cfgd  p10cfgd
 
        P10cfgd normally does not require the IP_PORT parameter. It listens for
        connections on IP Port 1236 as a default.
 
        The program will send on a line by line basis the file requested by the
        client  that connects on the IP Port.  The only expected input from the
        client is the file name.  When the file has been sent,  the  connection
        is closed. The requested file must be in the directory /etc/p10cfgd.
 
        Rmtcfgd    maintains    a   log   of   its   activity   in   the   file
        /var/log/p10cfgd.log.  Program startup and all connections  are  logged
        in the file with GMT time stamps.  The file is opened in append mode.
 
        The protocol used by the PackeTen is very simple.  The PackeTen opens a
        tcp connection to port 1236 on a host system. Once  the  connection  is
        made,  the  PackeTen  sends  the name of the file it wants to the host.
        The host then opens the file and sends it line by line to the  PackeTen
        until  all  lines  have  been sent.  The files to be transfered must be
        plain text files and each line must have  at  least  one  character  in
        addition  to  the newline at the end.  P10cfgd replaces all blank lines
        with lines that contain two spaces.  If you wish to send a blank  line,
        to  stop  loading  of  part  of  a LocalInfo file for example, place an
        underscore ’_’ at the begining of the line. The entire contents of  the
        line  will  be deleted and a blank line will be sent to the client.  At
        the end of the file, the server sends a time command ( time  MMDDYYHHMM
        )  with  the  UTC time on the server.  This will either set the time on
        the PackeTen or add a time stamp to the  LocalInfo  file.   The  server
        then closes the connection.
 
        The remote configuration command used on the PackeTen is
             rmtcfg <server_host> <filename> [options]
             The valid options are
                  -t  <timeout in seconds>  default is 60 sec
                  -p  <IP port #>           default is 1236
                  -i                     the file is for LocalInfo
                  -h  <secondary server>    if the primary does not answer
 
        The  rmtcfg   commands would be placed in to the EEPROM on the PackeTen
        so that they would be executed during a reboot.  The information stored
        in  the EEPROM should include enough information to set the PackeTen up
        to allow communications with the  primary  and  the  secondary  server.
        This would include commands to set MYCALL and the IP_ADDRESS, to attach
        an interface to the channel with the server, routing information and so
        forth.     A    sample    EEPROM    configuration   for   a   PackeTen,
        empire.wd0fhg.ampr.org [44.32.0.32], that gets its configuration from a
        remote system winfree.n3eua.ampr.org [44.32.0.2], over a 9600 baud ax25
        path would be:
 
             # first the general setup of the PackeTen
             ee hostname gw.wd0fhg
             ee sitename empire
             ee ipaddr  44.32.0.32
             ee mycall WD0FHG
             # Then we attach a 9600 ax25 interface as ax1
             ee attach sync302 1 hdx ax25 ax1 8192 256 9600 ext ext nrzi
             # and set the default route to send every thing out ax1
             ee route add default ax1 44.32.0.1
             ee password sure-thing
             #
             # Now we will ask for the remainder of the setup
             # from the server winfree.n3eua.ampr.org [44.32.0.2]
             # Note that we have a secondary server available at
             # [44.20.0.195] that would be used if winfree is down.
             # first the Local Information file
             ee com 0 rmtcfg 44.32.0.2 empire.info -i -h 44.20.0.195
             # and then the remaining configuration command file
             ee com 1 rmtcfg 44.32.0.2 empire.cfg -h 44.20.0.195
             #
             ee save
             #    end-of-eeprom setup
 
        Rmtcfgd started life as the simple server program in PERL by Larry Wall
        and R.L. Schwartz published by ORA,Inc.
 

ENVIRONMENT

        No environment variables are used.
 

FILES

        /etc/p10cfgd/*      - files that can be accessed remotely
        /var/log/p10cfgd.log     - p10cfgd log file
 

AUTHOR

        John Conner, WD0FHG,  conner@empire.com
        hacked on by Bdale Garbee, N3EUA, bdale@gag.com.
        Gracilis, Inc. PackeTen Manual and NOS User’s Manual
 

DIAGNOSTICS

        Complains if it can’t open a file to remote client and to log file.