Museum

NAME_$CNAME                       Domain/OS                        NAME_$CNAME


NAME
     name_$cname - change a leaf name

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

     void name_$cname(
          char *old_pathname,
          unsigned short &old_length,
          char *new_leaf,
          unsigned short &leaf_length,
          status_$t *status)

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

     procedure name_$cname(
          in old_pathname: univ name_$long_pname_t;
          in old_length: integer;
          in new_leaf: univ name_$long_name_t;
          in leaf_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 old_length, leaf_length
           character old_pathname*1023, new_leaf*255

           call name_$cname(old_pathname, old_length, new_leaf,
          &                 leaf_length, status)

DESCRIPTION
     Name_$cname changes the leaf name of old_pathname to new_leaf, thus
     renaming the entry without moving it from its current directory.

     old_pathname
          An existing pathname to change.

     old_length
          The number of bytes in old_pathname.

     new_leaf
          The new leaf name to replace the old leaf name in old_pathname.

     leaf_length
          The number of bytes in new_leaf.

     status
          The completion status.