pad_raw() — Apollo

PAD_$RAW                          Domain/OS                           PAD_$RAW


NAME
     pad_$raw - place a pad in raw mode

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pad.h>

     void pad_$raw(
          ios_$id_t &stream_id,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pad.ins.pas';

     procedure pad_$raw(
          in stream_id: ios_$id_t;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pad.ins.ftn'

           integer*4 status
           integer*2 stream_id

           call pad_$raw(stream_id, status)

DESCRIPTION
     Pad_$raw puts the pad open on stream_id into raw mode, and has no effect
     if it is already in raw mode.  In raw mode, the Display Manager sends
     ASCII input from the keyboard directly to the calling process without
     echoing or processing it in any way, but still interprets its function
     keys.  Input and output are not buffered into records; each keystroke is
     forwarded as it is entered in the input pad, and the result of each write
     are sent immediately to the transcript pad.  Pad_$newline is treated as
     just another character in raw mode.  Pad_$cooked returns the pad to nor-
     mal processing.

     A call to pad_$raw causes the Display Manager to clear the input pad and
     shrink its window size to zero.  The Display Manager also moves the key-
     board cursor to the current output cursor position in the transcript pad.
     While the pad is in raw mode, the keyboard and output cursors usually
     move together.

     A program should not leave an open pad in raw mode on termination.  Most
     system utilities do not work correctly in raw mode.

     stream_id
          The stream ID of the pad.  Stream_id should refer to an input
          stream, usually standard input (ios_$stdin).

     status
          The completion status.
Museum
