JNOS Commands Manual - The P Commands

The P Command Set

param <iface> [<param> [<value>]]

     Param invokes a device-specific control routine.  A simple 'param
<iface>' will give a list of available parameters and their current
values, for the interface <iface>.  <param>  can be the literal name
of the parameter, or it can be its numeric index (see below).  <value>
is either a boolean value (such as ON or OFF) converted to 1 or 0, or
an integer.

     On a serial interface,  the param command sends control packets
over the serial port.  For example, 'param port1 txdelay  255' will set
the keyup timer (called txdelay) on the KISS TNC configured as port1 to
2.55 seconds (255 x .01 sec).  In most TNC KISS implementations, a 10ms
tick count is used, so that (for example) 30 means 300ms, and a limit
of 255 is imposed on <value>.

     The SCC driver, on the other hand, allows a limit of 65535 for <value>.

Currently supported <params> include:
Name (index)      Definition

TxDelay (1)       keyup delay before sending data
Persist (2)       the csma persistence (range 0-255) (probability of success
SlotTime (3)      the channel access slottime (how often we throw the dice)
TxTail (4)        time to keep transmitter keyed up after end of packet
FullDup (5)       simultaneous TX and RX enabled when ON
Hardware (6)
TxMute (7)
DTR (8)           Assert DTR when true, de-assert when false.
RTS (9)           Assert RTS when true, de-assert when false.
Speed (10)        async baud, etc.
EndDelay (11)
Group (12)        SCC iface group id and TX-interlock style
Idle (13)
Min (14)
MaxKey (15)       maximum time to allow transmitter to be keyed (0 - 65000)
Wait (16)
Down (129)        De-assert RTS and DTR on serial port
Up (130)          Assert RTS and DTR on serial port
Blind (131)       Ignore CTS and DSR transitions on serial port
RcvMode (253)     set packet driver receive mode
Return2 (254)     TNC partially (!!) exits KISS mode
Return (255)      TNC exits KISS mode

Additional information for selected <params>:

The GROUP param specified an integer whose low-order 8 bits provide a
transmit-group number (0 implies no group membership), and whose remaining
bits provide flags describing that group's behavior:
1 => only transmit when all receive channels in this group are clear.
2 => don't transmit simultaneously on interfaces in this group.


pause <seconds>

        Pauses for the specified number of seconds.  This command is
        commonly used in the autoexec.nos file when loading in large
        routing tables or to pause after various time critical commands.



ping <host> [<length> [<repeat_ms> [<incflag>]]]

     Verify a host is alive, by sending it ICMP Echo Request packets.

     <host> is the address to ping.

     <length> is the number of bytes to use in the data portion of the
     packet being built.  <length> defaults to a small value, sufficient
     to contain a timestamp to facilitate determining round-trip timing.
     Any additional data bytes will contain 0x55 characters ('U').

     <repeat_ms> specifies that instead of sending a single ping, a session
     is to be established to do repeated pings every <repeat_ms> MILLISECONDS.
     A running display of attempts, round-trip times, and mean deviation of
     round-trip times is maintained in this session.  To terminate the
     session, press F10 and then use the reset command.

     <incflag> indicates that the host IP address is to be incremented
     by one at each ping attempt.  It is intended to help search blocks
     of IP addresses for active hosts.  It should be used sparingly if
     at all.


popmail <subcommands>

    popmail addserver <host> [<seconds>] [hh:mm-hh:mm] <protocol>
    <mailbox> <username> <password>


     Add hostP as a pop server. When seconds is given, a timer is
started to query the  host with that interval for mail. If not
specified no quering to the pop host  will be started. You have
to do that manually with a kick.  When  hh:mm is given then only
in that exact timeframe are queries to the host made (allowed).
Protocol is either POP2 or POP3, depending on the  mail service
the host is providing.

     A JNOS POP server host need only 'start' the pop2 or pop3 daemon, and
configure the popusers file, to make his/her system accessible to pop
clients.    

       Note: pop2 is superseded by pop3.  If MD5AUTHENTICATE is #define'd
       JNOS pop3 supports the apop technique, which avoids, were possible,
       sending a plain-text password.

       Mailbox is the mailbox name on the host where mail has to be
       picked up.

       Username and password are this system's validation parameters for
       the host.

       Note: On entering this command the host name is looked up. If
       nonexistent, an error message is displayed.


     popmail dropserver <host>

      Drops host from the list of pop servers to be queried.  All
      references to the entry are deleted from the current system.


    popmail kick <host>

     Starts a pop session with host to retrieve mail.  This command is
     needed  when no interval is specified with the popmail addserver
     command.


    popmail list

     Lists the current popmail server table.


    popmail lzw  [on|off]

      Enables, disables lzw compression for popmail.


    popmail quiet <yes|no>

     Displays or sets the notification of new mail arriving via pop.


    popmail trace <level>

     Displays or sets the trace level of pop sessions. Current trace
     levels are:

      0 - No tracing
      1 - Serious errors reported
      2 - Transient errors reported
      3 - session progress reported

     Note that tracing only goes to the log file.


   popmail t4 [<#seconds>]                   Default: 0

     Displays or sets the pop client's idle timeout value (in seconds).
     Zero means no timeout, otherwise the value should be at least
     300 seconds.  This command is only available when POPT4 was
     #define'd when JNOS was compiled.


prompt [on | OFF]

     The 'prompt' command sets or displays the value of the MSDOS-Style
prompt switch.  If set ON, and status lines are not enabled, the current
directory is printed as the first part of the console command prompt.



ps

     Display process status information. The first line shows the time
the system has been running, the active stack segment, the interrupt stack
usage, and the JNOS psp segment.  Note that the DOS JNOS code is loaded at
segment address psp+0x10.  Next, ps displays all processes in the system.

The fields are as follows:

     PID - Process ID (the segment of the process descriptor).

     SP - The current value of this process' stack pointer.

     maxstk - The size of the stack allocated to this process.

     stksize - The apparent peak stack utilization of this process.
     This is done in a  somewhat  heuristic  fashion, so the numbers
     should be treated as approximate. If this number is close to the
     maxstk figure, the system is likely to crash.  Please notify the
     author if you find such a situation.  (The program should be
     recompiled to give the process a larger allocation when it is
     started.)

     event - The event this process is waiting for, if it is not
     runnable.  This is actually a pointer value.

     fl - Process status flags. There are three: I (Interrupts
     enabled), W  (Waiting  for event) and S (suspended). The I flag
     is set whenever a task has executed a pwait() call (wait for
     event) without first disabling hardware interrupts.  Only tasks
     that wait for hardware interrupt events will turn off this flag;
     this is done to avoid critical sections and missed  interrupts.
     The  W flag  indicates  that  the  process is waiting for an
     event; the 'event' column will be non-blank. Note that although
     there may be several runnable processes at  any  time  (shown  in
     the 'ps' listing as those without the W flag and with blank event
     fields) only one process is actually running at any  one  instant
     (The  Refrigerator  Light  Effect  says that the 'ps' command is
     always the one running when this display is generated.)



pwd [<directory>]

        An alias for the 'cd' command.