ms_attributes()

MS_$ATTRIBUTES                    Domain/OS                     MS_$ATTRIBUTES


NAME
     ms_$attributes - get the file attributes of a mapped object

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

     void ms_$attributes(
          void *&address,
          ms_$attrib_t *attrib_buf,
          short int *attrib_len,
          short int &attrib_max,
          status_$t *status)

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

     procedure ms_$attributes(
          in address: univ_ptr;
          out attrib_buf: ms_$attrib_t;
          out attrib_len: integer;
          in attrib_max: integer;
          out status: status_$t);

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

           integer*4 status
           integer*2 attrib_len, attrib_max
           character*1 attrib_buf(22)

           integer*4 cur_len, blocks_used, dtu, dtm, dtcr
           character*1 permanent, immutable

           equivalence (permanent, attrib_buf(1)),
           equivalence (immutable, attrib_buf(2)),
           equivalence (cur_len, attrib_buf(3)),
           equivalence (blocks_used, attrib_buf(7)),
           equivalence (dtu, attrib_buf(11)),
           equivalence (dtm, attrib_buf(15)),
           equivalence (dtcr, attrib_buf(19))

           integer*4 address, dummy
           pointer /address/ dummy

           call ms_$attributes(address, attrib_buf, attrib_len, attrib_max, status)

DESCRIPTION
     This call gets the file attributes of a mapped object.  The attributes
     supplied by ms_$attributes include whether it is permanent or temporary,
     whether it is immutable or modifiable, its current length, and the times
     the object was created, last modified, and last used.

     address
          A pointer to the mapped object whose attributes are needed.

     attrib_buf
          A buffer to receive the attributes.

     attrib_len
          The number of bytes supplied in attrib_buf.

     attrib_max
          The number of bytes available in attrib_buf.  Ms_$attributes will
          not write more than attrib_max bytes into attrib_buf.

     status
          The completion status.

SEE ALSO
     ios_$inq_file_attr, ios_$inq_obj_flags, ios_$set_obj_flag, ms_$truncate.
Museum
