SYSTEM FILES AND DEVICES REFERENCE

(1)

---

^-

^{- - --}

^-

R E F E R E N C E

SYSTEM FILES AND DEVICES REFERENCE

UNIX® SVR4.2

• ^~

^~

(2)

REFERENCE MANUAL DESCRIPTION SECTIONS

Command Reference General-Purpose User Commands 1 (Commands a - I) Basic Networking Commands 1C

Form and Menu Language Interpreter 1F

System Maintenance Commands 1M

Command Reference (same as above) (Commands m - z)

Operating System API System Calls 2

Reference BSD System Compatibility Library 3

Standard C Library 3C

ETI-curses Library 3curses

Executable and Linking Format Library 3E

General-Purp0l>e Library 3G

Identification and Authentication Library 31

Math Library 3M

Networking Library 3N

Standard I/O Library 3S

Multibyte/wide Character Conversion Library 3W

Specialized Libraries 3X

Windowing System API Desktop Metaphor 3Dt

Reference Drag and Drop 3DnD

MoOLIT 30lit

ETI-curses Library 3curses

System Files and Devices System File Formats 4 Reference Miscellaneous Facilities 5

Special Files (Devices) 7

Device Driver DDI/DKI Driver Data Definitions D1 Reference DDI/DKI Driver Entry Point Routines D2

DDI/DKI Kernel Utility Routines D3

Portable Device Interface (PDI) Routines D3G SCSI Device Interface (SDI) Routines D31

DDI/DKI Kernel Data Structures D4

SCSI Device Interface (SDI) Data Structures D41

DDI/DKI Kernel Defines D5

(3)

SYSTEM FILES AND DEVICES

REFERENCE

UNIXSVR4.2

Edited by Lynda Feng

UNIX

Press

(4)

Printed In USA

Published by Prentice-Hall, Inc.

A Simon & Schuster Company Englewood Cliffs, New Jersey 07632

No part of this publication may be reproduced or transmitted in any form or by any means-graphic, electronic, electrical, mechanical, or chemical, including photocopying, recording in any medium, tap- ing, by any computer or information storage and retrieval systems, etc., without prior permissions in writing from UNIX System Laboratories, Inc. (USL).

IMPORTANT NOTE TO USERS

While every effort has been made to ensure the accuracy and completeness of all information in this document, USL assumes no liability to any party for any loss or damage caused by errors or omissions or by statements of any kind in this document, its updates, supplements, or speCial editions, whether such errors, omissions, or statements result from negligence, accident, or any other cause. USL further assumes no liability ariSing out of the application or use of any product or system described herein;

nor any liability for incidental or consequential damages arising from the use of this document. USL disclaims all warranties regarding the information contsined herein, whether expressed, implied or statutory, including Implied warranties of merchantability or fitness for a particular purpose.

usi..

makes no representation that the interconnection of products in the manner described herein will not infringe on existing or future patent rights, nor do the descriptions contained herein imply the grant- ing of any license to make, use or sell equipment constructed in accordance with this description.

USL reserves the right to make changes to any products herein without further notice.

TRADEMARKS

UNIX is a registered trademark of UNIX System Laboratories, Inc. in the USA and other countries.

WE is a registered trademark of AT&T.

XENIX is a registered trademark of Microsoft Corporation.

10 9 8 7 6 5 4 3 2 1

ISBN 0-13-017682-6

UNIX

PRESS A Prentice Hall Title

(5)

PRENTICE HALL

ORDERING INFORMATION

UNIX@ SYSTEM V RELEASE 4.2 DOCUMENTATION

To order single copies of UNIX@ SYSTEM V Release 4.2 documentation, please call (515) 284-6761.

ATTENTION DOCUMENTATION MANAGERS AND TRAINING DIRECTORS:

For bulk purchases in excess of 30 copies, please write to:

Corporate Sales Department PTR Prentice Hall

113 Sylvan Avenue

Englewood Cliffs, N.J. 07632 or

Phone: (201) 592-2863 FAX: (201) 592-2249

ATTENTION GOVERNMENT CUSTOMERS:

For GSA and other pricing information, please call (201) 461-7107.

Prentice-Hall International (UK) Limited,

London

Prentice-Hall of Australia Pty. Limited,

Sydney

Prentice-Hall Canada Inc.,

Toronto

Prentice-Hall Hispanoamericana, S.A.,

Mexico

Prentice-Hall of India Private Limited,

New Delhi

Prentice-Hall of Japan, Inc.,

Tokyo

Simon & Schuster Asia Pte. Ltd.,

Singapore

Editora Prentice-Hall do Brasil, Ltda.,

Rio de Janeiro

(6)

(7)

Introduction File Formats

a.out(4) ... ELF (Executable and Linking Format) files acct(4) ... per-process accounting file format admin(4) ... installation defaults file aliases, addresses, forward(4) ... (BSD) addresses and aliases for sendmail ar(4) ... archive file format archives (4) ... device header file binarsys(4) ... remote system information for the ckbinarsys command boot (4) ... boot options bootparams(4) ... boot parameter data base compver(4) ... compatible versions file copyright (4) ... copyright information file core (4) ... core image file cron, queuedefs(4) ... option files for crontab and at depend (4) ... software dependencies files dfstab (4) ... file containing commands for sharing resources dirent(4) ... file system independent directory entry dir (cdfs)(4) ... format of CD-ROM file system (cdfs) directory data structure dir (s5)(4) ... format of s5 directories dir (ufs) (4) ... format of ufs directories disk.dg(4) ... configuration defaults for mass-storage and SCSI devices dump (4) ... boot dump timeout file ethers (4) ... Ethernet address to hostname database or domain fd(4) ... file descriptor files filehdr(4) ... file header for common object file (COFF) fspec(4) ... format specification in text files fstypes(4) ... file that registers distributed file system packages fs (bfs)(4) ... format of the bfs file system volume fs (cdfs)(4) ... format of a cdfs file system fs (s5) (4) ... format of s5 file system volume fs (sfs)(4) ... format of sfs file system volume fs (ufs)(4) ... format of ufs file system volume fs (vxfs) (4) ... format of vxfs file system volume gettydefs(4) ... speed and terminal settings used by getty

(8)

holidays (4) ... accounting file hosts (4) ... host name data base hosts.equiv, .rhosts(4) ... trusted hosts by system and by user inetd.conf(4) ... Internet servers database Init(4) ... inittab entries for a kernel module inittab (4) ... script for init inode (bfs)(4) ... format of a bfs i-node inode (cdfs)(4) ... format of a cdfs inode inode (s5)(4) ... format of an s5 i-node inode (sfs)(4) ... format of a sfs inode inode (ufs)(4) ... format of a ufs inode inode (vxfs)(4) ... format of a vxfs inode interface (4) ... Internet network interface configuration parameters issue (4) ... issue identification file lid_and -IJriv (4) ... distributed file system security database limits (4) ... header file for implementation-specific constants login (4) ... login default file loginlog(4) ... log of failed login attempts mailcnfg(4) ... initialization information for mail and rmail mailsurr(4) ... surrogate commands for routing and transport of mail mapchan(4) ... format of tty device mapping files Master (4) ... generic configuration information for a kernel module menu (4) ... form description file for menu(l) command mkdev(4) ... file format for the pdimkdev utility mnttab (4) ... mounted file system table Mtune(4) ... tunable parameter definitions netconfig(4) ... network configuration database netdrivers(4) ... data file for networking boards to protocols mappings netmasks(4) ... network mask data base netrc(4) ... file for ftp remote login data networks (4) ... network name data base Node (4) ... device node definitions for a device driver OHcValues(4) ... Input Context attribute names and value pairs OHm Values (4) ... a list of 1M attributes passwd(4) ... password file pathalias(4) ... alias file for FACE pkginfo(4) ... package characteristics file pkgmap(4) ... package contents description file pnch(4) ... file format for card images priv(4) ... privilege data file PrivTable(4) ... privilege table proc(4) ... process file system profile (4) ... setting up an environment at login time protocols (4) ... protocol name data base

6 Table of Contents

(9)

prototype (4) ... package information file publickey(4) ... public key database Rc (4) ... system startup script res_major (4) ... reserved major numbers for base system device drivers resolv.conf(4) ... configuration file for name server routines rfmaster(4) ... Remote File Sharing name server master file routing (4) ... system supporting for packet network routing rpc (4) ... rpc program number data base rt_ dptbl(4) ... real-time dispatcher parameter table Sassign(4) ... configurable device variables sccsfile(4) ... format of SCCS file Sd (4) ... kernel module system shutdown script services(4) ... Internet services and aliases setinfo(4) ... set characteristics file setsize(4) ... disk space requirements file shadow (4) ... shadow password file sharetab(4) ... shared file system table space (4) ... disk space requirement file Space.c(4) ... configuration-dependent kernel module data structure initializations stat (4) ... (XENIX) data returned by stat system call strcf(4) ... STREAMS Configuration File for STREAMS TCP lIP strftime(4) ... language-specific strings Stubs.c(4) ... stubs for kernel module symbols stune(4) ... local system settings for tunable parameters su(4) ... su options file syslog.conf(4) ... (BSD) configuration file for syslogd system log daemon System (4) ... system-specific configuration information for a kernel module tc.index(4) ... configuration index file for mass-storage devices term (4) ... format of compiled term file terminfo(4 N) ... terminal capability data base timezone(4) ... set default system time zone ttydefs(4) ... file contains terminal line settings information for ttymon ttysrch(4) ... directory search list for ttymap and ttyname unistd (4) ... header file for symbolic constants updaters(4) ... configuration file for Network Information Service (NIS) updating utrnp, wtmp(4) ... utmp and wtmp entry formats utrnpx, wtmpx(4) ... utrnpx and wtrnpx entry formats uuencode(4) ... format of an encoded uuencode file vfstab(4) ... table of file system defaults Xwincmaps(4) ... XWIN color map file Xwinconfig(4) ... XWIN configuration file Xwinfont(4) ... XWIN font configuration and defaults file (scalable and bitrnapped)

(10)

Miscellaneous Facilities

intro(5) ... introduction to miscellany ascii (5) ... map of ASCII character set environ (5) ... user environment eqnchar(5) ... (BSD) special character definitions for eqn eucioctl(5) ... generic interface to EVC handling tty drivers and modules fcntl(5) ... file control options font (5) ... font description files for troff and dpost iconv(5) ... code set conversion tables langinfo(5) ... language information constants man (5) ... macros to format Reference Manual pages math (5) ... math functions and constants me (5) ... (BSD) macros for formatting papers ms(5) ... (BSD) text formatting macros nl_types(5) ... native language data types priv(5) ... include file for user-level privilege definitions privilege (5) ... include file for privilege mechanism definitions prof (5) ... profile within a function . regexp: compile, step, advance (5) ... regular expression compile and match routines siginfo(5) ... signal generation information signal (5) ... base signals stat (5) ... data returned by stat system call stdarg(5) ... handle variable argument list term (5) ... conventional names for terminals types (5) ... primitive system data types ucontext(5) ... user context values (5) ... machine-dependent values varargs (5) ... handle variable argument list wstat(5) ... wait status

Special Files

intro(7) ... introduction to special files adsc (7) ... Adaptec 1542A SCSI host adapter subsystem alp(7) ... algorithm pool management module ARP(7) ... Address Resolution Protocol asyc(7) ... asynchronous serial port clone(7) ... open any major/minor device pair on a STREAMS driver connld (7) ... line discipline for unique stream connections console (7) ... STREAMS-based console interface cram (7) ... CMOS RAM interface

(11)

DCD(7) ... Direct-Coupled Disk host adapter SubsystenL display (7) ... system console display dpt(7) ... DPT PM2012 SCSI host adapter subsystem ee16(7) ... EtherExpress 16 Ethernet Adapter Driver e116(7) ... EtherLink 16 Ethernet Adapter Driver fd(7) ... diskette (floppy disk) file system (7) ... file system organization iS96 (7) ... iS96 Ethernet Driver ibmtok(7) ... IBM Token Ring Driver ICMP (7) ... Internet Control Message Protocol ie6(7) ... 3CS03 3Com Ethernet Driver if (7) ... general properties of Internet Protocol network interfaces imxS86 (7) ... IMXLANS86 Intel Ethernet Driver inet(7) ... Internet protocol family IP(7) ... Internet Protocol kbd(7) ... generalized string translation module keyboard (7) ... system console keyboard kmem(7) ... perform I/O on kernel memory based on symbol name Idterm(7) ... standard STREAMS terminal line discipline module 10(7) ... software loopback network interface log(7) ... interface to STREAMS error logging and event tracing lp(7) ... parallel port interface mcis(7) ... MCIS SCSI host adapter driver mem, kmem (7) ... core memory mouse(7) ... mouse device driver for bus, serial, and PS/2 mouse devices null (7) ... the null file pckt(7) ... STREAMS Packet Mode module prf(7) ... operating system profiler ptem(7) ... STREAMS pseudo-terminal emulation module pty(7) ... STREAMS pseudo-terminal driver rtc(7) ... real time clock interface sad(7) ... STREAMS Administrative Driver sc01(7) ... CD-ROM Target Driver sd01 (7) ... PDI disk target driver sockio(7) ... ioctls that operate directly on sockets st01 (7) ... Portable Device Interface (PDI) tape target driver streamio (7) ... STREAMS ioctl commands swOl(7) ... Portable Device Interface (PDI) WORM Target Driver sxt(7) ... pseudo-device driver TCP(7) ... Internet Transmission Control Protocol termio (7) ... general terminal interface termiox(7) ... extended general terminal interface

(12)

tirdwr(7) ... Transport Interface read/write interface STREAMS module ttcompat(7) ... V7, 4BSD and XENIX STREAMS compatibility module tty (7) ... controlling terminal interface UDP(7) ... Internet User Datagram Protocol vxfsio (7) ... vxfs file system control functions wd(7) ... Western Digital WD8003 Ethernet Driver wd7000 (7) ... WD7000 FASST2 host adapter subsystem zero (7) ... source of zeroes

Permuted Index

(13)

Introduction

Computers keep track of thousands and thousands of details. To save the labor of continuously respecifying these details, information that is used repeatedly is stored in files, which the operating system references when needed. For example, when you turn the power on, the operating system reads a file that specifies which disks to mount; when you log in, it validates your password and sets up your environment; when you copy files from a remote system, it maps the software names to the network addresses.

The System Files and Devices Reference describes the system and device files in the UNIX System, including both special files and regular files. Special files per- tain to a particular hardware device; regular files are hardware-independent. The book also includes a set of miscellaneous manual pages. Not all of the files and devices described in this manual are available on every UNIX system. Some of the features require additional utilities that may not exist on your system.

The System Files and Devices Reference is part of a comprehensive UNIX system reference set, which describes commands, system calls, libraries, and files. This book includes all manual pages in sections 4, 5, and 7. References to manual pages in other sections are found in other books in the reference set. The inner front cover of this book lists the various section numbers and the books in which they are found.

Manual Page Format

All manual page entries use a common format, not all of whose parts always appear:

• The NAME section gives the name(s) of the entry and briefly states its purpose.

• The SYNOPSIS section summarizes the use of the command, program or function, or names the relevant special file.

• The DESCRIPTION section describes the utility.

• The EXAMPLE section gives example(s) of usage, where appropriate.

• The FILES section gives the file names that are built into the program.

• The SEE ALSO section gives pointers to related information. Reference to manual pages with section numbers other than those in this book can be found in other reference manuals, as listed above.

(14)

• The DIAGNOSTICS section discusses the diagnostic indications that may be produced. Messages that are intended to be self-explanatory are not listed.

• The NOTES section gives generally helpful hints about the use of the utility.

Request for Comment

A Request for Comment (RFC) is a document that describes some aspect of networking technology. The RFCs cited in the SEE ALSO section of these manual pages are available in hardcopy from:

Jon Postel RFC Editor

USC Information Sciences Institute 4676 Admiralty Way

Marina del Rey, CA 90292-6695

Online versions of the RFCs are available by FTP from nic.ddn.mil. To connect to this host, type:

ftp -n nic.ddn.mil

Log in with the user name anonymous and the password guest. To retrieve the RFC, type get rfc: rfcnum • txt, where num is replaced by the number of the RFC. For example, to retrieve RFC 1171, type

get rfc:rfcl171.txt

At the end of the ftp session, type quit to exit.

2 Introduction

(15)

a.out(4)

NAME

a.out - ELF (Executable and Linking Format) files SYNOPSIS

#include <elf.h>

DESCRIPTION

The file name a.out is the default output file name from the link editor, Id(l). The link editor will make an a. out executable if there were no errors in linking. The output file of the assembler, as(l), also follows the format of the a.out file although its default file name is different.

Programs that manipulate ELF files may use the library that el£(3E) describes. An overview of the file format follows. For more complete information, see the references given below.

Linking View Execution View

ELF header ELF header

Program header table Program header table optional

Section 1

... Segment 1

Section n

... Segment 2

.. . .

..

Section header table Section header table optional

An ELF header resides at the beginning and holds a "road map" describing the file's organization. Sections hold the bulk of object file information for the linking view: instructions, data, symbol table, relocation information, and so on. Segments hold the object file information for the program execution view. As shown, a segment may contain one or more sections.

A program header table, if present, tells the system how to create a process image.

Files used to build a process image (execute a program) must have a program header table; relocatable files do not need one. A section header table contains information describing the file's sections. Every section has an entry in the table;

each entry gives information such as the section name, the section size, and so on.

Files used during linking must have a section header table; other object files mayor may not have one.

Although the figure shows the program header table immediately after the ELF header, and the section header table following the sections, actual files may differ.

Moreover, sections and segments have no specified order. Only the ELF header has a fixed position in the file.

When an a.out file is loaded into memory for execution, three logical segments are set up: the text segment, the data segment (initialized data followed by uninitial- ized, the latter actually being initialized to all D's), and a stack. The text segment is not writable by the program; if other processes are executing the same a.out file,

(16)

a.out

(4)

The data segment starts at the next maximal page boundary past the last text address. (If the system supports more than one page size, the "maximal page" is the largest supported size.) When the process image is created, the part of the file holding the end of text and the beginning of data may appear twice. The duplicated chunk of text that appears at the beginning of data is never executed; it is duplicated so that the operating system may bring in pieces of the file in multiples of the actual page size without having to realign the beginning of the data section to a page boundary. Therefore, the first data address is the sum of the next maximal page boundary past the end of text plus the remainder of the last text address divided by the maximal page size. If the last text address is a multiple of the maximal page size, no duplication is necessary. The stack is automatically extended as required. The data segment is extended as requested by the brk(2) system calL SEE ALSO

as(l), brk(2), cc(l), elf(3E), Id(l)

4

(17)

acct(4)

NAME

acct - per-process accounting file format SYNOPSIS

#include <sys/types.h>

#include <sys/acct.h>

DESCRIPTION

Files produced as a result of calling acct(2) have records in the form defined by sys/acct.h, whose contents are:

typedef ushort COInp_ti /* "floating point" */

struct acct

{

}i

char char

ac_flagi ac_stati uid_t ac_uidi gid_t aC--9'idi dev_t ac_ttYi time_t ac_btimei COInp_t ac_utimei comp_t ac_stimei COInp_t ac_etimei COInp_t ac_memi COInp_t ac_ioi COInp_t ac_rwi char ac_camm[81i

/* 13-bit fraction, 3-bit exponent */

/* Accounting flag */

/* Exit status */

/* Accounting user ID */

/* Accounting group ID */

/* control typewriter */

/* Beginning time */

/* acctng user time in clock ticks */

/* acctng system time in clock ticks */

/* acctng elapsed time in clock ticks */

/* memory usage in clicks */

/* chars trnsfrd by read/write */

/* number of block reads/writes */

/ *

command name

* /

extern extern

struct struct

acct acctbufi

vnode *acctpi /* vnode of accounting file */

#define AFORK 01 /* has executed fork, but no exec */

#define ASU 02 /* used super-user privileges */

#define ACCTF 0300 /* record type: 00

=

^{acct */}

#define AEXPND 040 /* Expanded Record Type*/

In ac_flag, the AFORK flag is turned on by each fork and turned off by an exec.

The ac_camm field is inherited from the parent process and is reset by any exec.

Each time the system charges the process with a clock tick, it also adds to ac_mem the current process size, computed as follows:

(data size) + (text size) / (number of in-core processes using text)

The value of ac_mem/ (ac_stime+ac_utime) can be viewed as an approximation to the mean process size, as modified by text sharing.

The structure tacct, which resides with the source files of the accounting commands, represents the total accounting format used by the various accounting commands:

(18)

acct(4)

/*

*

total accounting (for acct period), also for day

*/

struct tacct {

uid_t ta_uid; /* userid */

char ta_name[8]; /* login name */

float ta_cpu[2] ; /* cum. cpu time, p/np (mins) float ta_kcore[2]; /* cum kcore-minutes, p/np */

*/

float ta_con[2]; /* cum. connect time, p/np, mins

float ta_du; _/*cum. disk usage */

long ta-pc; /* count of processes */

unsigned short ta_sc; /* count of login sessions */

unsigned short ta_dc; /* count of disk samples */

unsigned short ta_fee; /* fee for special services */

} ; SEE ALSO NOTES

6

acct(lM), acct(2), acctcom(l), exec(2), fork(2)

The ac_mem value for a short-lived command gives little information about the actual size of the command, because ac_mem may be incremented while a different command (for example, the shell) is being executed by the process.

*/

(19)

admin(4)

NAME

admin - installation defaults file DESCRIPTION

admin is a generic name for an ASCII file that defines default installation actions by assigning values to installation parameters. For example, it allows administrators to define how to proceed when the package being installed already exists on the system.

/var/sadm/install/admin/default is the default admin file delivered with your system. The default file is not writable, so to assign values different from this file, create a new admin file. There are no naming restrictions for admin files. Name the file when installing a package with the -a option of pkgadd(lM). If the -a option is not used, the default admin file is used.

Each entry in the admin file is a line that establishes the value of a parameter in the following form:

param=value

Eleven parameters can be defined in an admin file. A file is not required to assign values to all eleven parameters. If a value is not assigned, pkgadd asks the installer how to proceed.

The eleven parameters and their possible values are shown below except as noted.

They may be specified in any order. Any of these parameters can be assigned the value ask, which means that, if the situation occurs, the installer is notified and asked to supply instructions at that time.

basedir Indicates the base directory where relocatable packages are to be installed. The value may contain ^$PKGINSTto indicate a base directory that is to be a function of the package instance.

mail Defines a list of users to whom mail should be sent following installation of a package. If the list is empty, no mail is sent. If the parameter is not present in the admin file, the default value of root is used. The ask value cannot be used with this parameter.

runlevel Indicates resolution if the run level (system state) is not correct for the installation or removal of a package. Options are:

nocheck Do not check for run level (system state).

quit Abort installation if run level (system state) is not met.

conflict Specifies what to do if an installation expects to overwrite a previ- ously installed file, thus creating a conflict between packages. Options are:

nocheck Do not check for conflict; files in conflict will be overwritten.

quit Abort installation if conflict is detected.

nochange Override installation of conflicting files; they will not be installed.

(20)

admin(4)

8

setuid

action

Checks for executables which will have setuid or setgid bits enabled after installation. Options are:

nocheck Do not check for setuid executables.

quit Abort installation if setuid processes are detected.

nochange Override installation of setuid processes; processes will be installed without setuid bits enabled.

Determines if action scripts provided by package developers contain possible security impact. Options are:

nocheck Ignore security impact of action scripts.

quit Abort installation if action scripts may have a negative security impact.

partial Checks to see if a version of the package is already partially installed on the system. Options are:

nocheck Do not check for a partially installed package.

quit Abort installation if a partially installed package exists.

instance Determines how to handle installation if a previous version of the package (including a partially installed instance) already exists.

Options are:

idepend

rdepend

quit Exit without installing if an instance of the package already exists (does not overwrite existing packages).

overwrite Overwrite an existing package if only one instance exists. If there is more than one instance, but only one has the same architecture, it overwrites that instance.

Otherwise, the installer is prompted with existing instances and asked which to overwrite. If an instance of the package was already fully installed, then it does not do a space check.

unique Do not overwrite an existing instance of a package.

Instead, a new instance of the package is created. The new instance will be assigned the next available instance identifier.

Controls resolution if other packages depend on the one to be installed. Options are:

nocheck Do not check package dependencies.

quit Abort installation if package dependencies are not met.

Controls resolution if other packages depend on the one to be removed. Options are:

nocheck Do not check package dependencies.

quit Abort removal if package dependencies are not met.

(21)

NOTES space

admin (4)

Controls resolution if disk space requirements for package are not met. Options are:

nocheck quit

Do not check space requirements (installation fails if it runs out of space).

Abort installation if space requirements are not met.

The value ask should not be defined in an admin file that will be used for non- interactive installation (since by definition, there is no installer interaction). Doing so causes installation to fail when input is needed.

EXAMPLES

basedir=default runlevel=quit conflict=quit setuid=quit action=quit partial=quit instance=unique idepend=quit rdepend=quit space=quit SEE ALSO

pkgadd(lM)

(22)

aliases (4)

(BSD System Compatibility)

NAME

aliases, addresses, forward - (BSD) addresses and aliases for sendmail SYNOPSIS

/usr/ucblib/aliases /usr/ucblib/aliases.dir /usr/ucblib/aliases.pag - / • forward

DESCRIPTION

10

These files contain mail addresses or aliases, recognized by sandmail, for the local host:

/etc/passwd Mail addresses (usernames) of local users.

/usr/ucblib/aliases

Aliases for the local host, in ASCII format. This file can be edited to add, update, or delete local mail aliases.

/usr/ucblib/aliases. { dir , pag}

The aliasing information from /usr/ucblib/aliases, in binary, dl:m format for use by sandmail. The program, newaliases, maintains these files.

- / • forward Addresses to which a user's mail is forwarded (see AutCllllatic Forwarding, below).

In addition, the Network Information Service (NIS) aliases map mail.aliases contains addresses and aliases available for use across the network.

Addresses

As distributed, sandmail supports the following types of addresses:

Local Usernames username

Each local username is listed in the local host's /etc/passwd file.

Local Filenames pathname

Messages addressed to the absolute pathname of a file are appended to that file.

Commands

I command

If the first character of the address is a vertical bar, ( I ), sandmail pipes the message to the standard input of the command the bar precedes.

DARPA-standard Addresses username@domain

If domain does not contain any I.' (dots), then it is interpreted as the name of a host in the current domain. Otherwise, the message is passed to a mailhost that deter- mines how to get to the specified domain. Domains are divided into subdomains separated by dots, with the top-level domain on the right. Top-level domains include:

(23)

(BSD System Compatibility)

Commercial organizations.

Educational organizations.

Government organizations.

Military organizations.

For example, the full address of John Smith could be:

js@jsmachine.Podunk-u.EDU

if he uses the machine named j smachine at Podunk University.

uucp Addresses

... [host! ] host! username

aliases (4)

These are sometimes mistakenly referred to as "Usenet" addresses. uucp provides links to numerous sites throughout the world for the remote copying of files.

Other site-specific forms of addressing can be added by customizing the sendmail configuration file. See the sendmail(lM) for details. Standard addresses are recommended.

Aliases Local Aliases

/usr/ucblib/aliases is formatted as a series of lines of the form aliasname: address[, address]

aliasname is the name of the alias or alias group, and address is the address of a recipient in the group. Aliases can be nested. That is, an address can be the name of another alias group. Because of the way sendmail performs mapping from upper- case to lower-case, an address that is the name of another alias group must not contain any upper-case letters.

Lines beginning with white space are treated as continuation lines for the preceding alias. Lines beginning with # are comments.

Special Aliases An alias of the form:

owner- aliasname : address

directs error-messages resulting from mail to aliasname to address, instead of back to the person who sent the message.

An alias of the form:

aliasname: : include: pathname

with colons as shown, adds the recipients listed in the file pathname to the aliasname alias. This allows a private list to be maintained separately from the aliases file.

NIS Domain Aliases

Normally, the aliases file on the master NIS server is used for themail.aliases NIS map, which can be made available to every NIS client. Thus, the /usr/ucblib/aliases* files on the various hosts in a network will one day be

(24)

aliases (4)

(BSO System Compatibility)

obsolete. Domain-wide aliases should ultimately be resolved into usernames on specific hosts. For example, if the following were in the domain-wide alias file:

jsmith:js@jsmachine

then any NIS client could just mail to jsmith and not have to remember the machine and username for John Smith. If a NIS alias does not resolve to an address with a specific host, then the name of the NIS domain is used. There should be an alias of the domain name for a host in this case. For example, the alias:

jsmith:root

sends mail on a NIS client to root@podunk-u if the name of the NIS domain is podunk-u.

Automatic Forwarding

FILES

When an alias (or address) is resolved to the name of a user on the local host, sandmail checks for a . forward file, owned by the intended recipient, in that user's home directory, and with universal read access. This file can contain one or more addresses or aliases as described above, each of which is sent a copy of the user's mail.

Care must be taken to avoid creating addressing loops in the . forward file. When forwarding mail between machines, be sure that the destination machine does not return the mail to the sender through the operation of any NIS aliases. Otherwise, copies of the message may "bounce." Usually, the solution is to change the NIS alias to direct mail to the proper destination.

A backslash before a username inhibits further aliasing. For instance, to invoke the vacation program, user j s creates a . forward file that contains the line:

\js, "I/usr/ucb/vacation js"

so that one copy of the message is sent to the user, and another is piped into the vacation program.

/etc/passwd

/usr/ucblib/aliases -/.forward

ar(4)

NAME

ar - archive file format SYNOPSIS

#include <ar.h>

DESCRIPTION

The archive command ar [see ar(l)] is used to combine several files into one.

Archives are used mainly as libraries to be searched by the link editor ld [see ld(l)].

Each archive begins with a unique string identifier called an archive magic string.

#define 1IRMAG " !<arch>\n" /* magic string */

#define SARMAG 8 /* length of magic string */

Following the archive magic string are the archive file members. Each file member is preceded by a file member header which is of the following format:

#define ARFMAG "'\n^ll /* header trailer string */

struct ar_hdr /* file member header */

{

char ar_name [16] ; /* '/' terminated file member name */

char ar_date[12]; /* file member date */

char ar_uid[6]; /* file member user identification */

char ar_gid[6]; /* file member group identification */

char ar_mode[8] ; /* file member mode (octal) */

char ar_size[10]; /* file member size */

char ar_fmag[2] ; /* header trailer string */

};

All information in the file member headers is in printable ASCII. The numeric information contained in the headers is stored as decimal numbers (except for ar _mode which is in octal). Thus, if the archive contains printable files, the archive itself is printable.

If the file member name fits, the ar _name field contains the name directly, and is terminated by a slash (I) and padded with blanks on the right. If the member's name does not fit, ar _name contains a slash (I) followed by a decimal representation of the name's offset in the archive string table described below.

The ar date field is the modification date of the file at the time of its insertion into the arChive. Common format archives can be moved from system to system as long as the portable archive command ar is used.

Each archive file member begins on an even byte boundary; a newline is inserted between files if necessary. Nevertheless, the size given reflects the actual size of the file exclusive of padding.

Notice there is no provision for empty areas in an archive file.

(26)

ar (4)

14

Each archive that contains object files [see a.out(4)] includes an archive symbol table. This symbol table is used by the link editor Id to determine which archive members must be loaded during the link edit process. The archive symbol table (if it exists) is always the first file in the archive (but is never listed) and is automatically created and/ or updated by ar.

The archive symbol table has a zero length name (that is, ar_name [01 is '/,), ar_name [1] ==' ',and so on). All "words" in this symbol table have four bytes, using the machine-independent encoding shown below. (All machines use the encoding described here for the symbol table, even if the machine's "natural" byte order is different.)

Ox01020304

The contents of the symbol table are as follows:

1. The number of symbols. Length: 4 bytes.

2. The array of offsets, one per symbol, into the archive file. Length: 4 bytes

*

"the number of symbols".

3. The name string table. Length: ar _size -4 bytes

*

("the number of symbols"

+ 1).

As an example, the following symbol table defines 4 symbols. The archive member at file offset 114 defines name and object. The archive member at file offset 426 defines function and a second version of name.

Offset +0 + 1 +2 +3

o

4 4 offset entries

4 8 12 16 20 24 28 32 36 40 44

n

\0 e f t

\0 e

114 114 426 426 a

0

c u i n

\0 m b t n

0

a e j

\0 c n m

name object function name

The number of symbols and the array of offsets are managed with sgetl and sputl. The string table contains exactly as many null terminated strings as there are elements in the offsets array. Each offset from the array is associated with the corresponding name from the string table (in order). The names in the string table are all the defined global symbols found in the common object files in the archive.

Each offset is the location of the archive header for the associated symbol.

(27)

ar(4)

If some archive member's name is more than 15 bytes long, a special archive member contains a table of file names, each followed by a slash and a new-line.

This string table member, if present, will precede all "normal" archive members.

The special archive symbol table is not a "normal" member, and must be first if it exists. The ar _name entry of the string table's member header holds a zero length name ar_name[O]=='I', followed by one trailing slash (ar_name[l] =='1'), followed by blanks (ar_name [2] ==' " and so on). Offsets into the string table begin at zero. Example ar _name values for short and long file names appear below.

Offset +0 +1 +2 +3 +4 +5 +6 +7 +8 +9

o

10 20 30

f i

s a

n g

m e

Member Name short-name

file_name_sample longerfilenamexample

1 m e x

e _-

p 1

r f

a m

ar name short-namel 10

118

n e i p

a m e _-

I \n 1 0

1 e n a

1 e I \n

Note Not in string table Offset 0 in string table Offset 18 in string table SEE ALSO

NOTES

a.out(4), ar(I), Id(I), sputl(3X), strip(l)

strip will remove all archive symbol entries from the header. The archive symbol entries must be restored via the -ts options of the ar command before the archive can be used with the link editor Id.

(28)

archives (4)

NAME

archives - device header file DESCRIPTION

16

1* Magic numbers *1

#define CMtCASC Ox070701

#define CMtCBIN 070707

#define CMtCBBS 0143561

#define CMtCCRC Ox070702

#define CMS_ASC "070701"

#define CMS_CHR "070707"

#define CMS_CRC "070702"

#define CMICSEC Ox070703

#define CMS_SEC "070703"

#define CMS_LEN 6

1*

epio Magic Number for AScii header *1 epio Magic Number for Binary header *1 epio Magic Number for Byte-swap header *1 epio Magic Number for CRe header * I epio Magic String for AScii header * I epio Magic String for CHR (-c) header *1 epio Magic String for CRC header *1 Tcpio Magic Number of TIlE header *1 Tcpio Magic String of TIlE header *1 epio Magic String LENgth *1

1* Various header and field lengths *1

#define CHRSZ 76 1* -c hdr size minus filename field *1

#define ASCSZ 110 1* ASC and CRC hdr size minus filename field *1

#define TARSZ 512 1* TAR hdr size *1

#define HNAMLEN 256 1* maximum filename length for binary and -c headers *1

#define EXPNLEN 1024 1* maximum filename length for ABC and CRC headers *1

#define HTIMLEN 2 1* length of modification time field *1

#define HSIZLEN 2 1* length of file size field *1 1* cpio binary header definition *1

struct hdr_epio {

} ;

short h_magic, h_dev;

ushort_t h_ino,

short

char

h_mode, h_uid, h-9'id;

h_nlink, h_rdev,

h_mtime [HTIMLEN] , h_namesize,

h_filesize[HSIZLEN];

h_name[HNAMLEN];

1* epio one header format *1 struct c_hdr {

char c_magic[CMS_LEN], c_dev[6] ,

c_ino[6] , c_mode[6] , c_uid[6] , c-9'id[6] , c_n1ink[6] , c_rdev[6] , c_mtime[l1] , c_namesz [6], c_filesz [11],

1* magic number field *1 1* file system of file *1 1* inode of file *1 1* modes of file *1 1* uid of file *1 1* gid of file *1

1* number of links to file *1

1* maj/min numbers for special files *1 1* modification time of file *1

1* length of filename *1 1* size of file *1 1* filename *1

(29)

archives (4)

} ;

1* -c and CRC header format *1 struct Exp_cpio_hdr {

} ;

char E_magic[CMS_LEN], E_ino[8] ,

E_mode[8] , E_uid[8] , E.-9id[8] , E_nlink [8], E_mtime[8] , E_filesize[8] , E_maj[8], E_min[8] , E_rmaj [8], E_rmin[8] , E_namesize[8] , E_chksum[8] , E_name [EXPNLEN] ;

1* Tar header structure and format *1

#define TBLOCK 512 1* length of tar header and data blocks *1

#define

#define TMODLEN

TNAMLEN

8

100/* maximum length for tar file names *1 1* length of mode field *1

#define TUIDLEN 8 1* length of uid field *1

#define TGIDLEN 8 1* length of gid field *1

#define TSIZLEN 12 1* length of size field *1

#define TTIMLEN

#define TCRCLEN 12 8

1* length of modification time field *1 1* length of header checksum field *1 1* tar header definition *1

union tblock {

char dummy[TBLOCK];

struct tar_hdr {

char t_name [TNAMLEN] ,

t_mode [TMODLEN] ,

1* name of file *1 1* mode of file *1 t_uid [TUIDLEN] ,

t_gid [TGIDLEN] ,

1* uid of file *1 1* gid of file *1

1* size of file in bytes *1 t_size [TSIZLEN] ,

t_mtime [TTIMLEN] , t_cksum[TCRCLEN], t_typeflag,

t_linkname[TNAMLEN] ,1*

t_magic[TMAGLEN], t_version[TVERSLEN], t_uname [32],

t~[32],

t_devmajor[8] , t_devminor[8] , tJlrefix[155] ;

1* modification time of file *1 1* checksum of header *1

file this file linked with *1

(30)

archives (4)

1* volcopy tape label format and structure */

18

#define VMAGLEN 8

#define VVOLLEN 6

#define VFILLEN 464 struct vol copy_label

char v_magic [VMAGLEN], v_volume [VVOLLEN], v_reels,

long

char long int

v_reel;

v_time, v_length, v_dens, v_reelblks, v_blksize, v_nblocks;

v_fill [VFILLEN];

v_offset;

v_type;

1* u370 added field *1 1* u370 added field *1 1* u370 added field *1 1* used with -e and -reel 1* does tape have nblocks

options *1 field? *1

(31)

binarsys (4)

NAME

binarsys - remote system information for the ckbinarsys command DESCRIPTION

FILES

binarsys contains lines of the form:

remote_system _name: val

where val is either Y or N. This line indicates whether that particular remote system can properly deal with messages having binary content. The absence of an entry for a particular system or absence of the binarsys file altogether will imply No.

Blank lines or lines beginning with # are considered comments and ignored.

Should a line of Default=y be encountered, the default condition for missing entries described in the previous paragraph is reversed to be Yes. Another line of Default=n will restore the default condition to No.

mail is distributed with the binarsys file containing only a Default=y line.

/etc/mail/binarsys SEE ALSO

ckbinarsys(lM), mailsurr(4), mail(l)

(32)

boot (4)

NAME

boot - boot options

DESCRIPTION

FILES

Options for the boot program can be set or changed with keywords in / stand/boot. The following are recognized by boot.

BOOTMSG=string

Change the default boot message to string.

MEMRANGE=range:flag[,range:flag ... J

Tell boot where to look when sizing memory. A range is a pair of decimal addresses, separated by a dash such as lM-4M. The flag indicates how the range should be interpreted. The following flags are recognized:

256 -B MEM BASE (OxlOO) 512 -B=MEM=EXPAN (Ox200)

8704 -B_MEM]ORCE (Ox2000) + B_MEM_EXPAN

If / stand/boot does NOT exist, the boot program uses the CMOS values as the maximum when probing for RAM (default case).

If / stand/boot does exist, use the MEMRANGE entry to override the CMOS values. Examples:

Probe for the minimum of 4M or the CMOS values:

MEMRANGE=0-640K:256,lM-4M:512

Probe for 64MB and ignore the CMOS values as the maximum:

MEMRANGE=0-640K:256,lM-16M:512,16M-64M:8704

Note: if B_MEM_FORCE is set it will ignore the CMOS setting for that range. The CMOS setting can only be ignored for memory above 16MB and only if the initial address of the range is above 16MB.

In addresses, use "M" to indicate megabytes and "K" to indicate kilobytes.

The first address in the pair is inclusive; the last address is exclusive. When sizing the base memory (0-640K usually) the boot code checks the CMOS for the current base memory setting. If this value is less than the current base memory value, the kernel uses this lower value instead of 640K.

variable=value

All other lines of the form variable=value are passed as arguments to the kernel as is, via argv[].

/stand/boot

/etc/initprog/boot SEE ALSO

boot(l)

20

(33)

NAME

bootparams - boot parameter data base SYNOPSIS

bootparams DESCRIPTION

bootparams ( 4 )

bootparams contains a list of client entries that diskless clients use for booting.

Each entry contains the following information for each diskless client:

name server names and pathnames

The first field contains the name of the diskless client. The subsequent field is a list of keys, names of servers, and pathnames.

Fields are delineated with TABs.

A client entry in the local bootparams file supersedes an entry in the corresponding Network Information Service (NIS) map.

EXAMPLE

This is an example of the bootparams file.

clientl root=grpserver:/nfsroot/ clientl \ swap=grpserver: / nfsswap / clientl \ dump=grpserver: / nfsdump / clientl SEE ALSO

bootparamd(lM)

(34)

compver(4)

NAME

cOlli>ver - compatible versions file DESCRIPTION

NOTES

COlli>ver is an ASCII file used to specify previous versions of the associated package which are upward compatible. It is created by a package developer.

Each line of the file specifies a previous version of the associated package with which the current version is backward compatible.

Since some packages may require installation of a specific version of another software package, compatibility information is extremely crucial. Consider, for example, a package called "A" which requires version "1.0" of application "B" as a prerequisite for installation. If the customer installing" A" has a newer version of

"B" (1.3), the compver file for "B" must indicate that "1.3" is compatible with version "1.0" in order for the customer to install package" A."

The comparison of the version string disregards white space and tabs. It is per- formed on a word-by-word basis. Thus 1.3 Enhanced and 1.3 Enhanced would be considered the same.

EXAMPLE

A sample compver file is shown below.

1.3 1.0 SEE ALSO

depend(4)

22

(35)

copyright ( 4 )

NAME

copyright - copyright information file

DESCRIPTION

copyright is an ASCII file used to provide a copyright notice for a package. The text may be in any format. The full file contents (including comment lines) is displayed on the terminal at the time of package installation.

(36)

core (4)

NAME

core - core image file DESCRIPTION

The UNIX system writes out a core image of a process when it is terminated due to the receipt of some signals. The core image is called core and is written in the process's current directory (provided it can be; normal access controls apply). A process with an effective user ID different from the real user ID will not produce a core image.

The core file contains all the process information pertinent to debugging: contents of hardware registers, process status and process data. The format of a core file is object file specific.

For ELF executable programs [see a.out(4)], the core file generated is also an ELF file, containing ELF program and file headers. The e_type field in the file header has type ET_CORE. The program header contains an entry for every loadable and writable segment that was part of the process address space, including shared library segments. The contents of the segments themselves are also part of the core image.

The program header of an ELF core file also contains a NOTE segment. This segment may contain the following entries. Each has entry name "CORE" and presents the contents of a system structure:

prstatus_t

The entry containing this structure has a NOTE type of 1. This structure contains things of interest to a debugger from the operating system's u-area, such as the general registers, signal dispositions, state, reason for stopping, process ID and so forth. The structure is defined in sys/procfs .h.

fpregset_t

This entry is present only if the process used the floating-point hardware. It has a NOTE type of 2 and contains the floating-point registers. The fpregset_t structure is defined in sys/regset.h.

prpsinfo_t

The entry containing this structure has a NOTE type of 3. It contains information of interest to the ps(l) command, such as process status, cpu usage,

"nice" value, controlling terminal, user ID, process ID, the name of the executable and so forth. The structure is defined in sys/procfs.h.

COFF executable programs produce core files consisting of two parts: the first section is a copy of the system's per-user data for the process, including the general registers. The format of this section is defined in the header files sys/user.h and sys/reg .h. The remainder of a COFF core image represents the actual contents of the process data space.

The size of the core file created by a process may be controlled by the user [see getrlimit(2)].

SEE ALSO

a.out(4), crash(lM), elf(3E), getrlimit(2), sdb(l), setuid(2), signal(5)

24

(37)

eron (4)

NAME

cron, queuedefs - option files for crontab and at DESCRIPTION

FILES

Options for cron(lM) can be set or changed with keywords in /etc/default/cron. The following keywords are recognized by cron:

CRONLOG=YES or NO If CRONLOG is set to YES, all cron jobs are logged in /usr/lib/cron/log. The default is NO.

Options for crontab(l) and at(l) can be set or changed with keywords in /etc/cron.d/queuedefs. The format of the file is as follows:

a.4jln b.2j2n90w

The first line specifies how at(l) jobs are to be handled:

Start a maximum of 4 concurrent jobs per user.

Use a nice(l) value of l.

Do not retry jobs that cannot start because fork(2) fails.

The second line specifies how crontab(l) jobs are to be handled:

Start a maximum of 2 concurrent jobs per user.

Use a nice(l) value of 2.

Wait 90 seconds, then try again to start jobs that cannot start because fork(2) fails.

/etc/default/cron Control logging of cron jobs.

/etc/cron.d/queuedefs Specify concurrency, priority, and retry interval.

depend (4)

NAME

depend - software dependencies files DESCRIPTION

depend is an

AScn me

used to specify information concerning software dependencies for a particular package. The file is created by a software developer.

Each entry in the depend file describes a single software package. The instance of the package is described after the entry line by giving the package architecture and/ or version. The format of each entry and subsequent instance definition is:

type pkg name (arch)version (arch)version The fields are:

type Defines the dependency type. Must be one of the following characters:

P Indicates a prerequisite for installation, for example, the referenced package or versions must be installed.

I Implies that the existence of the indicated package or version is incompatible.

R Indicates a reverse dependency. Instead of defining the package's own dependencies, this designates that another package depends on this one. This type should be used only when an old package does not have a depend

me

but it relies on the newer package nonetheless. Therefore, the present package should not be removed if the designated old package is still on the system since, if it is removed, the old package will no longer work.

pkg Indicates the package abbreviation.

name Specifies the full package name.

(arch)version Specifies a particular instance of the software. A version name cannot begin with a left parenthesis. The instance specifications, both arch and version, are completely optional but each must begin on a new line that begins with white space. If no version set is specified, any version of the indicated package will match. A version preceded by a tilde (-) indicates that any compatible version will be a match. [See compver(4).]

EXAMPLE

Here is a sample depend file (for the NFS package):

P base Base System

P nsu Networking Support utilities

P inet Internet utilities

P rpc Remote Procedure call utilities P dfs Distributed File System'Utilities

26

(39)

SEE ALSO cc:xrg;wer(4)

depend(4)

(40)

dfstab(4)

NAME

dfstal> - file containing commands for sharing resources DESCRIPTION

dfstal> resides in directory /ete/dfs and contains commands for sharing resources across a network. dfstal> gives a network administrator a uniform method of controlling the automatic sharing of local resources.

Each line of the dfstal> file consists of a share(lM) command. The dfstal> file can be read by the shell directly to share all resources, or network administrators can prepare their own shell scripts to execute particular lines from dfstal>.

The contents of dfstal> are executed automatically when the system enters run level 3.

SEE ALSO

share(lM), shareal1(lM)

28

(41)

dirent(4)

NAME

dirent - file system independent directory entry SYNOPSIS

#include <sys/types.h>

#include <sys/dirent.h>

DESCRIPTION

Different file system types may have different directory entries. The dirent structure defines a file system independent directory entry, which contains information common to directory entries in different file system types. A set of these structures is returned by the getdents(2) system call.

The dirent structure is defined below.

struct dirent {

};

ino_t off_t

unsigned short char

d_ino;

d_off;

d_reclen;

d_name[l] ;

The d_ino is a number which is unique for each file in the file system. The field d_off is the offset of the subsequent directory entry in the actual file system directory. The field d_name is the beginning of the character array giving the name of the directory entry. This name is null terminated and may have at most MAXNAMLEN characters. This results in file system independent directory entries being variable length entities. The value of d_reclen is the record length of this entry. This length is defined to be the number of bytes between the current entry and the next one, so that the next structure will be suitably aligned.

SEE ALSO

getdents(2)

(42)

dir(4)

(CD-ROM)

NAME

dir (cdfs) - format of CD-ROM file system (cdfs) directory data structure SYNOPSIS

#include <sys/fs/iso9660.h>

#include <sys/fs/cdfs_inode.h>

DESCRIPTION

30

In a cdfs file system, the contents of a file or directory are stored in contiguous physical sectors called an extent. The contents of a directory are stored in a single extent. The contents of a file may be stored in multiple non-adjacent extents. More than one file can share the same extent. The first sector of each extent may contain an Extended Attribute Record (XAR) that describes additional attributes of the file or directory (such as the User ID, Group ID, permissions).

Each directory in a cdfs filesystem contains two or more Directory Records. These directory records identify the file and subdirectories owned by the directory. For each file or subdirectory in the directory, there will exist one Directory Record for each extent belonging to that file/subdirectory. Each Directory Record is of variable length and contains information such as:

the name of the file or subdirectory the location and size of its extent a System Use Area

Note: For a multi-extent file, there will be one directory record for each extent in the file.

Each Directory Record has a System Use Area (SUA) that stores information about other operating system standards, such as additional file-related information not defined by the ISO-9660 specification. The SUA can be used to store information required to support POSIX standards. For example, the SUA can contain the device file major/minor numbers, which are defined by the POSIX standard. The System Use Sharing Protocol (SUSP) defines how the information in the SUA is defined.

The Directory Record data structure is defined in the iso9660.h header file. For each cdfs file and directory currently being referenced, an in-core data structure, struct cdfs_drec, is used to store the relevant portions of all of the Directory Records belonging to that file or directory. Each cdfs_drec also stores other information relating to the extent and/or Directory Record. The cdfs_drec structure is defined in the cdfs_inode. h header file.

The cdfs_drec structure is as follows:

SYSTEM FILES AND DEVICES REFERENCE

---

- - --

R E F E R E N C E

SYSTEM FILES AND DEVICES REFERENCE

UNIX® SVR4.2

• ~

SYSTEM FILES AND DEVICES

REFERENCE

UNIXSVR4.2

Edited by Lynda Feng

UNIX

Press

usi..

ISBN 0-13-017682-6

UNIX

PRENTICE HALL

London

Sydney

Toronto

Mexico

New Delhi

Tokyo

Singapore

Rio de Janeiro

Table of Contents

Introduction File Formats

Miscellaneous Facilities

Special Files

Permuted Index

Introduction

Manual Page Format

Request for Comment

a.out(4)

..

(4)

acct(4)

/ *

* /

=

acct(4)

*

admin(4)

admin(4)

admin (4)

aliases (4)

aliases (4)

aliases (4)

ar(4)

ar (4)

*

*

o

ar(4)

o

archives (4)

archives (4)

archives (4)

binarsys (4)

boot (4)

compver(4)

copyright ( 4 )

core (4)

eron (4)

depend (4)

AScn me

me

depend(4)

dfstab(4)

dirent(4)

dir(4)

^{- - --}

• ^~