htystat(1M)        RISC/os Reference Manual         htystat(1M)



NAME
     hty_stat - display HPS channel information

SYNOPSIS
     htystat [tcpfioexsda] [device] chan_num

DESCRIPTION
     htystat uses the HPS raw driver to retrieve channel parame-
     ters for an open channel (specified in chan_num) from an HPS
     board.  Htystat retrieves this information by issuing a
     number of AIOC_GETx commands and interpreting the resulting
     data.  The parameters are written to standard output.  The
     default host adapter is /dev/rhp0.

     The information displayed is analogous to the information in
     the  stty  command, but the HPS data is displayed relative
     to the definition of the board parameters rather than to the
     UNIX  tty  parameters.  This information is useful primarily
     for driver porting and validation, not for the casual user.

OPTIONS
     One or more of the following options must be selected:

     t    Display translate table.  This  option  may  only  be
          used in conjunction with either the i or o command.  It
          will display the 256 byte translate table if  input  or
          output  translation  is  enabled.   (See the AIOC_SETI,
          AIOC_GETI, AIOC_SETO, and AIOC_GETO commands.)

     c    Display system configuration.  Displays  the  current
          system  configuration.   This  option  applies  to  the
          entire HPS board, not to a specific channel.  (See  the
          AIOC_SETC and AIOC_GETC commands.)

     p    Display asynch protocol.  Displays the  current  baud
          rate,  number of bits, parity, and stop bits configura-
          tion.  (See the AIOC_SETP and AIOC_GETP commands.)

     f    Display flow control.  Displays the current flow con-
          trol modes  enabled  and the parameters and characters
          associated with them.  (See the AIOC_SETF and AIOC_GETF
          commands.)

     i    Display input parameters.  Displays the  input  modes
          enabled  and the parameters associated with them.  (See
          the AIOC_SETI and AIOC_GETI commands.)

     o    Display output parameters.  Displays the output modes
          enabled  and the parameters associated with them.  (See
          the AIOC_SETO and AIOC_GETO commands.)

     e    Display echo parameters.   Displays  the  echo  modes



                        Printed 11/19/92                   Page 1

htystat(1M)        RISC/os Reference Manual         htystat(1M)



          enabled  and  the  character  strings set up with them.
          (See the AIOC_SETE and AIOC_GETE commands.)

     x    Display extra parameters.  Currently not implemented.
          (See the AIOC_SETX and AIOC_GETX commands.)

     s    Display channel status.  This  displays  the  current
          modem  control  signals  and  the  number of characters
          queued up on the board for both input and output.  (See
          the AIOC_GETS command.)

     d    Set device file  name.   This  option  overrides  the
          default  device  name  of  /dev/rhp0. If this option is
          specified, device must  be  specified  in  the  command
          line.

     a    Output with all the above options set.

EXAMPLES
     The following example writes a formatted display of the flow
     control parameters for channel 0 to standard output:

          htystat f 0

     The following example writes a formatted display of  all  of
     the channel parameters for channel 56 to standard output:

          htystat tpfioes 56

     The following example writes  a  formatted  display  of  the
     input parameters for channel 1 on the second host adapter in
     the system:

          htystat id /dev/rhp1 1

SEE ALSO
     hty(7).
     hps.asynch.h.

DIAGNOSTICS
     If an  error  occurs  in  any  of  the  AIOC_GETx  commands,
     htystat  displays  the  error  message  associated with the
     error.

WARNINGS
     The program will exit if the specified tty line is not open.
     The  program  checks for the current version of the Terminal
     Control   Software   by    sending    a    system    version
     command(implementation  in  03A).   This  ensures that a get
     configuration command is not  sent  on  a  pre-03A  version,
     which will cause the HPS to crash.




 Page 2                 Printed 11/19/92

htystat(1M)        RISC/os Reference Manual         htystat(1M)



     Compile under UNIX System V:

          cc -O -I../include -o htystat htystat.c

     If compilation is done on a system that requires IOCB struc-
     ture alignment on 32-bit boundaries:

          cc -O -I../include -DHPSALIGN -o htystat htystat.c

     Use the BSD switch for Berkeley 4.2 UNIX systems.













































                        Printed 11/19/92                   Page 3