aboutsummaryrefslogtreecommitdiff
path: root/unix/os/doc/zfpath.hlp
blob: 920caab30fc9eda31c39ebc7dce3c6e2462ae7bc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
.help zfpath May84 "System Interface"
.ih
NAME
zfpath -- convert an OSFN into an absolute pathname
.ih
SYNOPSIS
.nf
zfpath (osfn, pathname, maxch, status)

char	osfn[ARB]		# OS filename
char	pathname[maxch]		# absolute pathname equiv. of OSFN
int	maxch, status
.fi
.ih
DESCRIPTION
Return the absolute pathname equivalent of an OS filename.  An absolute pathname
is an OSFN which does not depend on the current working directory.
If the argument \fIosfn\fR is null the pathname of the current working
directory is returned.
.ih
RETURN VALUE
ERR is returned if the translation cannot be performed for any reason,
or if the output string overflows.  If the operation is successful the
number of characters in the output string is returned.
.ih
NOTES
This primitive is normally coded in SPP since it does not communicate
with the host system.  Character string arguments are therefore not packed.
.ih
SEE ALSO
zfxdir, zfsubd
.endhelp