atnetwork(3)						       AtFS Toolkit Library						      atnetwork(3)

NAME

       atNetworkPath, atLocalPath - network path handling

SYNOPSIS

       #include <atfs.h>
       #include <atfstk.h>

       char* atNetworkPath (Af_key *aso);

       char* atLocalPath (char *networkPath);

DESCRIPTION

       atNetworkPath returns a network wide unique pathname for aso. The pathname has the following structure
						       <hostname>:<canonical_pathname>@<version>.
       Hostname is the name of the host controlling the device, where aso is stored. the canonical pathname is the real pathname (without symbolic
       links), where the object is located on that host.  The version number, including the introducing at-sign (@) is	optional.  For	busy  ver-
       sions, it may be missing or the string busy

       atLocalPath maps a network path name to a local path name. When the host information in the network path denotes a remote host, atLocalPath
       looks up /etc/mtab for a mapping of the network canonical pathname to a local path. The resulting pathname is a	local  pathname  in  bound
       notation
								   <pathname>[version]
       with the version number added in brackets. It may be converted into an ASO descriptor by calling atBindVersion (manual page atbind(3)).

RETURN VALUE

       Both  functions	return	the  resulting	string	in  static memory. The result will be overwritten on a subsequent call. On failure, a null
       pointer is returned.

SEE ALSO

       atbind(3)

FILES

       /etc/mtab

AtFStk-1.12						     Fri Jun 25 16:39:40 1993						      atnetwork(3)