name_read_link_lc()

NAME_$READ_LINK_LC                Domain/OS                 NAME_$READ_LINK_LC


NAME
     name_$read_link_lc - return the pathname associated with a link

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

     void name_$read_link_lc(
          char *link_name,
          unsigned short &name_length,
          unsigned short &maxlinklen,
          char *link_text,
          unsigned short *text_length,
          status_$t *status)

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

     procedure name_$read_link_lc(
          in link_name: univ name_$long_pname_t;
          in name_length: integer;
          in maxlinklen: integer;
          out link_text: univ name_$long_pname_t;
          out text_length: integer;
          out status: status_$t);

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

           integer*4 status
           integer*2 name_length, maxlinklen, text_length
           character link_name*1023, link_text*1023

           call name_$read_link_lc(link_name, name_length, maxlinklen,
          &                        link_text, text_length, status)

DESCRIPTION
     Name_$read_link_lc supplies the contents of the link at link_name in
     link_text.

     link_name
          The pathname of a link.  Link_name is the position of the link in
          the naming tree.

     name_length
          The number of bytes in link_name.

     maxlinklen
          The size of the buffer allocated to receive link_text.
          Name_$read_link_lc will not put more than maxlinklen bytes in
          link_text.

     link_text
          The pathname that the link at link_name resolves to.  Link_text is
          the position in the naming tree that the link makes equivalent to
          link_name.

     text_length
          The number of bytes in link_text.  The number of bytes in the
          requested link text.  If text_length is greater than the buffer size
          passed in maxlinklen, then the pathname supplied in link_text is
          truncated.

     status
          The completion status.
Museum
