.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: atnetwork.3[7.0] Fri Jun 25 16:39:40 1993 andy@cs.tu-berlin.de frozen $
..
.TH atnetwork 3 "Fri Jun 25 16:39:40 1993" "AtFStk-1.12" "AtFS Toolkit Library"
.SH NAME
atNetworkPath, atLocalPath \- network path handling
.SH SYNOPSIS
#include <atfs.h>
.br
#include <atfstk.h>
.sp
char* atNetworkPath (Af_key *aso);
.sp
char* atLocalPath (char *networkPath);
.sp
.SH DESCRIPTION
\fIatNetworkPath\fP returns a network wide unique pathname for
\fIaso\fP. The pathname has the following structure
.ce
\f(CB<hostname>:<canonical_pathname>@<version>\fP.
Hostname is the name of the host controlling the device, where
\fIaso\fP 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 \fCbusy\fP
.LP
\fIatLocalPath\fP 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
.ce
\f(CB<pathname>[version]\fP
with the version number added in brackets. It may be converted into an
ASO descriptor by calling atBindVersion (manual page atbind(3)).
.SH 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.
.SH SEE ALSO
atbind(3)
.SH FILES
/etc/mtab