86 lines
2.8 KiB
Groff
86 lines
2.8 KiB
Groff
.\" Copyright (c) 1992,1994,1996 Bunyip Information Systems Inc.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Archie 3.5
|
|
.\" August 1996
|
|
.\"
|
|
.\" @(#)anonftp_parser_output.5
|
|
.\"
|
|
.TH ANONFTP_PARSER_OUTPUT 5 "August 1996"
|
|
|
|
.SH SYNOPSIS
|
|
.B anonftp_parser_output
|
|
\- description of the output of the Archie anonymous FTP listing parsers
|
|
for the anonftp catalog
|
|
.SH DESCRIPTION
|
|
.PP
|
|
Currently all anonymous FTP listings in the Archie system are parsed from
|
|
the Operating System specific format in to a common Archie-defined parser
|
|
output format. This allows the system to have standard database
|
|
structures, and updating routines without having to worry abou the
|
|
individual characteristics of each operating system. This format is
|
|
described below. One of the underlying assumptions is that the file
|
|
system of the listing being parsed has a tree-like structure with the
|
|
concepts of internal nodes (directories) and leaves (files).
|
|
|
|
The parser output corresponding to a particular listing consists of a
|
|
sequence of variable length records, one record per file in the listing.
|
|
This is composed of a fixed "core" component followed by a variable
|
|
length string.
|
|
|
|
The core is composed of records with fields:
|
|
|
|
<file_size><date_time><parent><child><perms><flags>
|
|
|
|
where
|
|
|
|
.TP
|
|
.B <file_size>
|
|
Is and unsigned 32 bit quantity containing the size of the file.
|
|
.TP
|
|
.B <date_time>
|
|
An unsigned 32 bit quantity. It's value is interpreted as seconds UTC
|
|
(GMT) since Jan 1, 1970. The actual quantity that it represents varies
|
|
between operating systems, but it is typically the creation or last
|
|
modification time for the file in question.
|
|
.TP
|
|
.B
|
|
<parent>
|
|
Unsigned 32 bit quantity. It is the record number of the parent directory
|
|
in the current file. A value of zero signifies that the parent directory
|
|
is the root.
|
|
.TP
|
|
.B
|
|
<child>
|
|
Unsigned 32 bit. The record number of the first child of this directory.
|
|
It is zero if the current record describes a directory which has no
|
|
children. It is undefined for regular files.
|
|
.TP
|
|
.B <perms>
|
|
Unsigned 16 bit. Contains a bit vector for the permission field values
|
|
in an operating-system dependent fashion.
|
|
.TP
|
|
.B <flags>
|
|
Unsigned 16 bit. A bit vector of particular attributes of the entry.
|
|
Currently if the entry is a directory, bit 1 is set. If it is a link, bit
|
|
2 is set.
|
|
.LP
|
|
|
|
The rest of the record consists of an unsigned 16 bit quantity containing
|
|
the length of the string (in bytes) in the record. This value is always
|
|
rounded up to the next multiple of 4. The final element is a variable
|
|
length byte sequence containing the string itself. This is always padded
|
|
up to the next 4-byte boundary.
|
|
.SH "SEE ALSO"
|
|
.BR parse_anonftp_* (n),
|
|
.BR net_anonftp (n),
|
|
Archie System Manual
|
|
.SH AUTHOR
|
|
Bunyip Information Systems.
|
|
.br
|
|
Montr\o"\'e"al, Qu\o"\'e"bec, Canada
|
|
|
|
.sp
|
|
Archie is a registered trademark of Bunyip Information Systems Inc., Canada,
|
|
1990.
|