Museum

IOS_$INQ_PATH_NAME_LC             Domain/OS              IOS_$INQ_PATH_NAME_LC


NAME
     ios_$inq_path_name_lc - get an object's pathname

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

     void ios_$inq_path_name_lc(
          ios_$id_t &stream_id,
          ios_$name_type_t &name_type,
          short &buffer_length,
          char *pathname,
          short *namelength,
          status_$t *status)

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

     procedure ios_$inq_path_name_lc(
          in stream_id: ios_$id_t;
          in name_type: ios_$name_type_t;
          in buffer_length: integer;
          out pathname: univ name_$long_pname_t;
          out namelength: integer;
          out status: status_$t);

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

           integer*2 stream_id, name_type
           integer*2 buffer_length, name_length
           integer*4 status
           character pathname*1023

           call ios_$inq_path_name_lc(stream_id, name_type, buffer_length
          &                           pathname, name_length, status)

DESCRIPTION
     Ios_$inq_path_name_lc gets the pathname of the object open on stream_id.

     stream_id
          The ID of a stream on which the object is open.

     name_type
          This specifies the type of pathname that ios_$inq_path_name_lc
          should return.  Choose one of the following:

          ios_$root_name
               An absolute pathname relative to the network root directory.
               Example: //node/sid/file.

          ios_$wdir_name
               A leaf name if the pathname can be found in the current working
               directory.  Otherwise, the pathname is an absolute pathname.

          ios_$ndir_name
               A leaf name if if the pathname can be found in the current nam-
               ing directory.  Otherwise, the pathname is an absolute path-
               name.

          ios_$node_name
               A pathname relative to the node's entry directory if the path-
               name exists in the node's boot volume.  Otherwise, the pathname
               is an absolute pathname.

          ios_$node_data_flag
               A leaf name if the pathname is in the current `node_data direc-
               tory.  Otherwise, the pathname is an absolute pathname.

          ios_$leaf_name
               A leaf name.

          ios_$resid_name
               A residual name if the object has an extended name.  The
               returned name is the extension maintained by the type manager.

     buffer_length
          The number of bytes in the buffer allocated to receive pathname.
          Ios_$get_dir_lc returns up to buffer_length bytes of the pathname of
          the object in pathname.  If there are more than buffer_length bytes
          in the object's pathname it is truncated to fit in pathname.

     pathname
          The pathname of the object open on stream_id, in the format speci-
          fied by name_type.

     namelength
          The number of bytes in pathname.

     status
          The completion status.