name_get_path_lc()

NAME_$GET_PATH_LC                 Domain/OS                  NAME_$GET_PATH_LC


NAME
     name_$get_path_lc - get a full pathname

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

     void name_$get_path_lc(
          char *partial_path,
          unsigned short &partial_len,
          unsigned short &max_len,
          char *full_name,
          unsigned short *full_len,
          status_$t *status)

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

     procedure name_$get_path_lc(
          in partial_path: univ name_$long_pname_t;
          in partial_len: integer;
          in maxpnamlen: pinteger;
          out full_name: univ name_$long_pname_t;
          out full_len: integer;
          out status: status_$t);

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

           integer*4 status
           integer*2 partial_len, max_len, full_len
           character partial_path*1023, full_name*1023

           call name_$get_path_lc(partial_path, partial_len, max_len,
          &                       full_name, full_len, status)

DESCRIPTION
     Name_$get_path_lc supplies an equivalent absolute pathname from the net-
     work root for the pathname passed to it in partial_path.

     partial_path
          A (probably partial) pathname.  The pathname supplied in
          partial_path must already exist in the naming tree.

     partial_len
          The number of bytes in partial_path.

     max_len
          The size of the buffer allocated to receive full_name.
          Name_$get_path_lc will not put more than max_len bytes in full_name.

     full_name
          An absolute pathname from the network root that is equivalent to the
          pathname passed in partial_path.

     full_len
          The number of bytes in the requested full pathname.  If full_len is
          greater than the buffer size passed in max_len, then the full path-
          name supplied in full_name is truncated.

     status
          The completion status.
Museum
