/usr/lib/iraf/unix/os/doc/zopdir.hlp is in iraf-dev 2.16.1+2018.03.10-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 33 34 | .help zopdir May84 "System Interface"
.ih
NAME
zopdir -- open a directory file
.ih
SYNOPSIS
.nf
zopdir (osfn, chan)
packed char osfn[] # directory file name
int chan # channel assigned to file
.fi
.ih
DESCRIPTION
The named directory file is opened for sequential access in READ_ONLY mode.
.ih
RETURN VALUE
ERR is returned in \fIchan\fR if the named file does not exist, is not a
directory, or cannot be accessed. A positive nonzero magic integer is
returned if the operation is successful.
.ih
NOTES
A directory file is opened at the kernel level with \fBzopdir\fR,
is read with \fBzgfdir\fR, and is closed with \fBzcldir\fR.
A directory file is viewed by the high level code as a simple list of
OS filenames; a directory file is interfaced to FIO as a text file and
successive filenames are read by the high level code with \fBgetline\fR.
The text file driver for a directory file is machine independent and
serves only as an interface between FIO and the three directory access
primitives.
.ih
SEE ALSO
zgfdir, zcldir
.endhelp
|