Museum

IOS_$INQ_CONN_FLAGS               Domain/OS                IOS_$INQ_CONN_FLAGS


NAME
     ios_$inq_conn_flags - return connection attributes

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

     ios_$conn_flag_set ios_$inq_conn_flags(
          ios_$id_t &stream_id,
          status_$t *status)

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

     function ios_$inq_conn_flags(
          in stream_id: ios_$id_t;
          out status: status_$t): ios_$conn_flag_set;

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

           integer*2 stream_id
           integer*4 conn_flags, status

           conn_flags = ios_$inq_conn_flags(stream_id, status)

DESCRIPTION
     Ios_$inq_conn_flags returns the set of connection attributes for the
     specified stream.  The value returned by ios_$inq_conn_flags is a Pascal
     set with the following elements:

          ios_$cf_append
               The connection's stream marker will be positioned at the end of
               the object (EOF) before each output call.

          ios_$cf_ipc
               The connection behaves like an interprocess communication (IPC)
               channel.

          ios_$cf_no_read
               The connection cannot be read.

          ios_$cf_read_intend_write
               The connection is open for read access and may later be opened
               for write access.  Other processes can read from the stream but
               cannot write to it or get "read with intent to write" access.

          ios_$cf_sequential
               The connection is accessible only by sequential I/O calls.

          ios_$cf_tty
               The connection behaves like a terminal.

          ios_$cf_unregulated
               Multiple processes can write to the connection.

          ios_$cf_vt
               The connection behaves like a virtual terminal.

          ios_$cf_write
               The connection can be written to.

     Domain/OS provides the following logical masks for analyzing the value
     returned by ios_$inq_conn_flags in FORTRAN and C.  The returned value is
     a bitwise OR of the following masks:

          ios_$cf_append_mask
               The connection's stream marker will be positioned at the end of
               the object (EOF) before each output call.

          ios_$cf_ipc_mask
               The connection behaves like an interprocess communication (IPC)
               channel.

          ios_$cf_no_read_mask
               The connection cannot be read.

          ios_$cf_read_intend_write_mask
               The connection is open for read access and may later be opened
               for write access.  Other processes can read from the stream but
               cannot write to it or get "read with intent to write" access.

          ios_$cf_sequential_mask
               The connection is accessible only by sequential I/O calls.

          ios_$cf_tty_mask
               The connection behaves like a terminal.

          ios_$cf_unregulated_mask
               Multiple processes can write to the connection.

          ios_$cf_vt_mask
               The connection behaves like a virtual terminal.

          ios_$cf_write_mask
               The connection can be written to.

     stream_id
          The stream ID of the connection.

     status
          The completion status.

NOTES
     Use ios_$set_conn_flags to change connection attributes.

SEE ALSO
     ios_$inq_file_attr, ios_$inq_mgr_flags, ios_$inq_obj_flags.