Xinu7/man/man2/namrepl.doc

NAMREPL(2)          Xinu Programmer's Manual           NAMREPL(2)



NAME
     namrepl - replace a name once using the syntactic namespace

SYNOPSIS
     int namrepl(name, newname)
     char *name;
     char *newname;

DESCRIPTION
     _N_a_m_r_e_p_l uses the syntactic namespace to translate a name
     into a new name and returns the id of a device to which the
     name maps.  The name is translated exactly once, independent
     of the device to which it maps.  In particular, _n_a_m_r_e_p_l will
     return the device id _N_A_M_E_S_P_A_C_E without further mapping for
     those names that map recursively through the syntactic
     namespace.

     Argument _n_a_m_e points to a null-terminated string containing
     the name to be mapped, and argument _n_e_w_n_a_m_e points to a
     string area large enough to hold the mapped version of the
     name.  If successful, _n_a_m_r_e_p_l returns the device id of the
     device to which the name maps.  Otherwise, it returns
     SYSERR.

SEE ALSO
     nammap(2), open(2), mount(2), unmount(2), namespace(4)

BUGS
     _N_a_m_r_e_p_l writes the mapped name into _n_e_w_n_a_m_e without checking
     to make sure it fits.  There is no way to distinguish errors
     such as string overflow from names that map to device
     SYSERR.























Version 6b               Printed 1/12/87                        1