Page 1261

These examples assume you use the simpleinit(8) init program for Linux. If you use a SysV-like init (does /etc/inittab mention "respawn"?), refer to the appropriate manual page.

ISSUE ESCAPES

The /etc/issue file might contain certain escape codes to display the system name, date and time, and so on. All escape codes consist of a backslash (\) immediately followed by one of the following letters:

b	Insert the baudrate of the current line.
d	Insert the current date.
s	Insert the system name, the name of the operating system.
l	Insert the name of the current tty line.
m	Insert the architecture identifier of the machine, such as i486.
n	Insert the nodename of the machine, also known as the hostname.
o	Insert the domain name of the machine.
r	Insert the release number of the OS, such as 1.1.9.
t	Insert the current time.
u	Insert the number of current users logged in.
U	Insert the string 1 user or n users where n is the number of current users logged in.
v	Insert the version of the OS, such as the build date and so on.

For example, on my system, the following /etc/issue file

This is \n.\o (\s\m\r) \t

displays as

This is thingol.orcan.dk (Linux i386 1.1.9) 18:29:30

FILES

/var/run/utmp, the system status file

/etc/issue, printed before the login prompt (System V only)

/dev/console, problem reports (if syslog(3) is not used)

/etc/inittab (Linux simpleinit(8) configuration file)

BUGS

The baud-rate detection feature (the -m option) requires that agetty be scheduled soon enough after completion of a dial-in call (within 30ms with modems that talk at 2400 baud). For robustness, always use the -m option in combination with a multiple baud rate command-line argument so that break processing is enabled.

The text in the /etc/issue file and the login prompt are always output with 7-bit characters and space parity.

The baud-rate detection feature (the -m option) requires that the modem emits its status message after raising the DCD line.

DIAGNOSTICS

Depending on how the program was configured, all diagnostics are written to the console device or reported via the syslog(3) facility. Error messages are produced if the port argument does not specify a terminal device, if there is no utmp entry for the current process (System V only), and so on.

AUTHORS

W.Z. Venema (wietse@wzv.win.tue.nl) Eindhoven University of Technology, Department of Mathematics and Computer Science, Den Dolech 2, P.O. Box 513, 5600 MB Eindhoven, The Netherlands.

Peter Orbaek (poe@daimi.aau.dk), Linux port.

Page 1262

CREATION DATE

Sat Nov 25 22:51:05 MET 1989

LAST MODIFICATION

91/09/01 23:22:00

VERSION/RELEASE

1.29

archive

archive—Usenet article archiver.

SYNOPSIS

archive [ -a archive ][-f ][-i index ][-m ][-r ][input ]

DESCRIPTION

archive makes copies of files specified on its standard input. It is usually run either as a channel feed under innd(8) or by a script before expire(8) is run.

archive reads the named input file or standard input if no file is given. The input is taken as a set of lines. Blank lines and lines starting with a number sign (#) are ignored. All other lines should specify the name of a file to archive. If a filename is not an absolute pathname, it is taken to be relative to /news/spool.

Files are copied to a directory within the archive directory, /news/spool/news.archive. The default is to create a hierarchy that mimics the input files; intermediate directories are created as needed. For example, the input file comp/sources/unix/2211 (article 2211 in the newsgroup comp.sources.unix) is copied to /news/spool/news.archive/comp/sources/unix/2211. If the _f flag is used, then all directory names are flattened out, replacing the slashes with periods. In this case, the file is copied to /news/spool/news.archive/comp.sources.unix/2211.

If the _i flag is used, then archive appends one line to the specified index file for each article that it copies. This line contains the destination name and the Message-ID and Subject headers.

For example, a typical newsfeeds(5) entry to archive most source newsgroups is as follows:

source-archive\
:!*,*sources*,!*wanted*,!*.d\
:Tc,Wn\
:/archive _f _i \
/usr/spool/news/news.archive/INDEX

Files are copied by making a link. If that fails, a new file is created. If the _m flag is used, then the file is copied to the destination, and the input file is replaced with a symbolic link pointing to the new file. The _m flag is ignored.

By default, archive sets its standard error to /var/log/news/errlog. To suppress this redirection, use the _r flag.

If the input is exhausted, archive exits with a zero status. If an I/O error occurs, it tries to spool its input, copying it to a file. If there was no input filename, the standard input is copied to /news/spool/out.going/archive and the program exits. If an input filename was given, a temporary file named input.bch (if input is an absolute pathname) or /news/spool/out.going/input.bch (if the filename does not begin with a slash) is created. Once the input is copied, archive tries to rename this temporary file to be the name of the input file and then exits.

HISTORY

Written by Rich $alz (rsalz@uunet.uu.net) for InterNetNews.

Previous | Table of Contents | Next