Museum

IOS_$GET_DIR_LC                   Domain/OS                    IOS_$GET_DIR_LC


NAME
     ios_$get_dir_lc - get the current working or naming directory

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

     void ios_$get_dir_lc(
          ios_$dir_type_t &dir_type,
          short &buffer_length,
          char *path_name,
          short *path_length,
          status_$t *status)

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

     procedure ios_$get_dir_lc(
          in dir_type: ios_$dir_type_t;
          in buffer_length: integer;
          out path_name: univ name_$long_pname_t;
          out path_length: integer;
          out status: status_$t);

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

           integer*2 dir_type, buffer_length, name_length
           integer*4 status
           character path_name*1023

           call ios_$get_dir_lc(dir_type, buffer_length, path_name, path_length, status)

DESCRIPTION
     Ios_$get_dir_lc gets the current working or naming directory.

     dir_type
          The type of directory to get.  Choose one of the following:

          ios_$ndir
               Get the name of the current naming directory.

          ios_$wdir
               Get the name of the current working directory.

     buffer_length
          The number of bytes in the buffer allocated to receive path_name.
          Ios_$get_dir_lc returns up to buffer_length bytes of the requested
          directory pathname in path_name.  If there are more than
          buffer_length bytes in the requested directory pathname it is trun-
          cated to fit in path_name.

     path_name
          The pathname of the requested directory.

     path_length
          The number of bytes in path_name.

     status
          The completion status.

NOTES
     A process can call ios_$set_dir to change the current working or naming
     directory.