atLocalPath(3) network path handling

Other Alias

atNetworkPath

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 versions, 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.

FILES

/etc/mtab