Annotation of src/share/man/man7/hier.7, Revision 1.81
1.81 ! lukem 1: .\" $NetBSD: hier.7,v 1.80 2008/01/09 11:26:13 simonb Exp $
1.7 jtc 2: .\"
1.10 mrg 3: .\" Copyright (c) 1990, 1993, 1994
1.7 jtc 4: .\" The Regents of the University of California. All rights reserved.
1.1 cgd 5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
1.58 agc 14: .\" 3. Neither the name of the University nor the names of its contributors
1.1 cgd 15: .\" may be used to endorse or promote products derived from this software
16: .\" without specific prior written permission.
17: .\"
18: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28: .\" SUCH DAMAGE.
29: .\"
1.10 mrg 30: .\" @(#)hier.7 8.5 (Berkeley) 6/1/94
1.1 cgd 31: .\"
1.81 ! lukem 32: .Dd May 22, 2008
1.1 cgd 33: .Dt HIER 7
34: .Os
35: .Sh NAME
36: .Nm hier
37: .Nd layout of filesystems
38: .Sh DESCRIPTION
1.10 mrg 39: An outline of the filesystem hierarchy.
1.27 fair 40: .Pp
41: Naming is very important.
42: The
43: .Ux
44: System relies on filename conventions for much of its power as a system.
45: The following file system layout describes generally where things are
46: and what they are, with references to other man pages for more detailed
47: documentation.
48: .Pp
49: Not all files will be in every system.
50: .Pp
1.10 mrg 51: .Bl -tag -width "/altroot/"
52: .It Sy \&/
53: root directory of the system
54: .It Sy /COPYRIGHT
1.27 fair 55: system copyright notice, most often put on
56: .Tn CD-ROM
57: distributions.
1.50 jmmv 58: .It Sy "/[a-z]/"
1.10 mrg 59: user filesystems
60: .It Sy /altroot/
61: alternate root filesystem, in case of disaster
1.63 wiz 62: .\" .It Sy /amd/
63: .\" home directories mount point; see
64: .\" .Xr amd 8
1.10 mrg 65: .It Sy /bin/
66: utilities used in both single and multi-user environments
1.30 lukem 67: .It Sy /boot*
68: second-stage boot loader(s) for some platforms; see
1.29 lukem 69: .Xr installboot 8
1.10 mrg 70: .It Sy /dev/
71: block, character and other special device files
1.1 cgd 72: .Pp
1.10 mrg 73: .Bl -tag -width "MAKEDEV" -compact
74: .It Sy MAKEDEV
1.1 cgd 75: script for creating device files;
76: see
77: .Xr makedev 8
1.10 mrg 78: .It Sy console
79: the computer's console device
1.52 perry 80: .It Sy drum
81: system swap space; see
82: .Xr drum 4
1.10 mrg 83: .It Sy fd/
1.1 cgd 84: file descriptor files;
85: see
1.17 fair 86: .Xr fd 4
1.10 mrg 87: .It Sy klog
88: kernel logging device; see
89: .Xr syslog 3
90: .It Sy kmem
91: kernel virtual memory device; see
92: .Xr mem 4
93: .It Sy log
1.16 fair 94: .Ux
95: domain datagram log socket; see
1.10 mrg 96: .Xr syslogd 8
97: .It Sy mem
98: kernel physical memory device; see
99: .Xr mem 4
1.52 perry 100: .It Sy null
101: the null device; see
102: .Xr null 4
1.10 mrg 103: .It Sy stderr
104: .It Sy stdin
105: .It Sy stdout
106: file descriptor files;
107: see
1.17 fair 108: .Xr fd 4
1.10 mrg 109: .It Sy tty
110: process' controlling terminal device; see
111: .Xr tty 4
1.32 enami 112: .It Sy zero
113: the zero device; see
114: .Xr zero 4
1.10 mrg 115: .El
1.63 wiz 116: .\" .It Sy /dump/
117: .\" online
118: .\" .Xr dump 8
119: .\" repository
1.10 mrg 120: .It Sy /etc/
1.17 fair 121: system configuration files and scripts
1.1 cgd 122: .Pp
1.10 mrg 123: .Bl -tag -width "master.passwd" -compact
124: .It Sy amd*
125: configuration files for
126: .Xr amd 8
127: .It Sy changelist
128: files backed up by the security script
129: .It Sy crontab
130: schedule used by the
131: .Xr cron 8
132: daemon
133: .It Sy csh.cshrc
134: .It Sy csh.login
135: .It Sy csh.logout
136: system-wide scripts for
137: .Xr csh 1
138: .It Sy daily
139: script run each day by
140: .Xr cron 8
1.29 lukem 141: .It Sy daily.conf
142: configuration file for
143: .Sy daily ;
1.1 cgd 144: see
1.29 lukem 145: .Xr daily.conf 5
146: .It Sy defaults/
147: default configuration files read by various
148: .Pa /etc/*.conf
149: files
1.10 mrg 150: .It Sy disktab
151: disk description file, see
152: .Xr disktab 5
153: .It Sy dm.conf
154: dungeon master configuration; see
155: .Xr dm.conf 5
156: .It Sy dumpdates
157: dump history; see
158: .Xr dump 8
159: .It Sy exports
160: filesystem export information; see
161: .Xr mountd 8
162: .It Sy fstab
163: filesystem information; see
164: .Xr fstab 5
165: and
166: .Xr mount 8
167: .It Sy ftpusers
168: users denied
169: .Xr ftp 1
170: access; see
171: .Xr ftpd 8
172: .It Sy ftpwelcome
173: .Xr ftp 1
174: initial message; see
175: .Xr ftpd 8
176: .It Sy gettytab
177: terminal configuration database; see
1.17 fair 178: .Xr gettytab 5
1.10 mrg 179: .It Sy group
180: group permissions file; see
181: .Xr group 5
182: .It Sy hosts
183: host name database backup for
184: .Xr named 8 ;
185: see
186: .Xr hosts 5
187: .It Sy hosts.equiv
188: trusted machines with equivalent user ID's
189: .It Sy hosts.lpd
190: trusted machines with printing privileges
191: .It Sy inetd.conf
192: Internet server configuration file; see
193: .Xr inetd 8
1.57 perry 194: .It Sy kerberosV/
195: configuration files for the kerberos version V;
1.1 cgd 196: see
1.33 wiz 197: .Xr kerberos 8
1.10 mrg 198: .It Sy localtime
199: local timezone information;
200: see
201: .Xr ctime 3
1.25 itojun 202: .It Sy mail/
203: configuration files for
204: .Xr sendmail 8
1.38 wiz 205: .Pp
1.25 itojun 206: .Bl -tag -width "sendmail.*" -compact
207: .It Sy aliases*
208: name alias files
209: .It Sy sendmail.*
210: .Xr sendmail 8
211: configuration information
212: .El
1.10 mrg 213: .It Sy mail.rc
214: system-wide initialization script for
215: .Xr mail 1
216: .It Sy man.conf
217: configuration file for
218: .Xr man 1 ;
219: see
220: .Xr man.conf 5
221: .It Sy master.passwd
1.52 perry 222: Main password file, readable only by root; see
223: .Xr passwd 5
1.14 hubertf 224: .It Sy mk.conf
225: optional file containing
226: .Xr make 1
1.17 fair 227: variables, read by pkgsrc and the system sources.
1.10 mrg 228: .It Sy monthly
229: script run each month by
230: .Xr cron 8
1.29 lukem 231: .It Sy monthly.conf
232: configuration file for
233: .Sy monthly ;
234: see
235: .Xr monthly.conf 5
1.10 mrg 236: .It Sy motd
237: system message of the day
1.17 fair 238: .It Sy mtree/
1.1 cgd 239: mtree configuration files;
240: see
1.17 fair 241: .Xr mtree 8
1.10 mrg 242: .It Sy named.*
1.17 fair 243: .It Sy namedb/
1.10 mrg 244: named configuration files and databases;
1.1 cgd 245: see
246: .Xr named 8
1.10 mrg 247: .It Sy netgroup
248: network groups; see
249: .Xr netgroup 5
250: .It Sy netstart
251: network startup script
252: .It Sy networks
253: network name data base; see
254: .Xr networks 5
1.52 perry 255: .It Sy passwd
256: World readable password file generated from master.passwd; see
257: .Xr passwd 5 ,
258: .Xr pwd_mkdb 8
1.10 mrg 259: .It Sy phones
260: remote host phone number data base; see
261: .Xr phones 5
262: .It Sy printcap
263: system printer configuration; see
264: .Xr printcap 5
265: .It Sy protocols
266: protocol name database; see
267: .Xr protocols 5
1.52 perry 268: .It Sy pwd.db
269: database form of passwd file; see
270: .Xr pwd_mkdb 8
1.10 mrg 271: .It Sy rc
1.55 perry 272: master system startup script invoked by
273: .Xr init 8 ;
274: see
1.10 mrg 275: .Xr rc 8
1.29 lukem 276: .It Sy rc.conf
277: configuration file for system startup and shutdown scripts; see
278: .Xr rc.conf 5
1.55 perry 279: .It Sy rc.d/
280: directory containing per-subsystem startup and shutdown scripts; see
281: .Xr rc 8
282: .It Sy rc.local
283: locally editable system startup script
284: .It Sy rc.shutdown
285: master system shutdown script invoked by
286: .Xr shutdown 8 ;
287: see
288: .Xr rc 8
1.10 mrg 289: .It Sy remote
290: remote host description file; see
291: .Xr remote 5
292: .It Sy security
293: daily (in)security script run by
294: .Xr cron 8
1.29 lukem 295: .It Sy security.conf
296: configuration file for
297: .Sy security ;
298: see
299: .Xr security.conf 5
1.10 mrg 300: .It Sy services
301: service name data base; see
302: .Xr services 5
303: .It Sy shells
304: list of permitted shells; see
305: .Xr shells 5
1.27 fair 306: .It Sy sliphome/
307: .Tn SLIP
308: login/logout scripts; see
309: .Xr sliplogin 8
1.52 perry 310: .It Sy spwd.db
311: database form of master.passwd file; see
312: .Xr pwd_mkdb 8
1.10 mrg 313: .It Sy syslog.conf
314: .Xr syslogd 8
315: configuration file; see
316: .Xr syslog.conf 5
317: .It Sy termcap
318: terminal type database; see
319: .Xr termcap 3
320: .It Sy ttys
321: terminal initialization information; see
322: .Xr ttys 5
323: .It Sy uucp/
324: UUCP configuration files; see
1.17 fair 325: .Xr uucp 1
1.10 mrg 326: and
327: .Xr uucico 8 .
328: .It Sy weekly
329: script run each week by
330: .Xr cron 8
1.29 lukem 331: .It Sy weekly.conf
332: configuration file for
333: .Sy weekly ;
334: see
335: .Xr weekly.conf 5
1.10 mrg 336: .El
337: .It Sy /home/
338: mount point for the automounter; see
339: .Xr amd 8
1.45 lukem 340: .It Sy /lib/
1.50 jmmv 341: dynamic linked libraries used by dynamic linked programs
1.45 lukem 342: (such as those in
1.50 jmmv 343: .Pa /bin/
1.45 lukem 344: and
1.50 jmmv 345: .Pa /sbin/ )
1.45 lukem 346: that cannot rely upon
1.50 jmmv 347: .Pa /usr/lib/
348: being available.
349: .It Sy /libexec/
350: system utilities (such as the dynamic linker) required by programs
351: and libraries that cannot rely upon
352: .Pa /usr/libexec/
1.45 lukem 353: being available.
1.10 mrg 354: .It Sy /mnt/
1.1 cgd 355: empty directory commonly used by
356: system administrators as a temporary mount point
1.10 mrg 357: .It Sy /netbsd
1.3 mycroft 358: pure kernel executable (the operating system loaded into memory
1.17 fair 359: at boot time).
1.45 lukem 360: .It Sy /rescue/
361: statically linked rescue tools, for use in system recovery
1.10 mrg 362: .It Sy /root/
363: home directory for the super-user
364: .Pp
365: .Bl -tag -width ".profile" -compact
366: .It Sy \&.cshrc
367: super-user start-up file
368: .It Sy \&.login
369: super-user start-up file
370: .It Sy \&.profile
371: super-user start-up file
1.55 perry 372: .It Sy \&.rhosts
373: super-user id mapping between machines
1.10 mrg 374: .El
375: .ne 1i
376: .It Sy /sbin/
1.1 cgd 377: system programs and administration utilities
1.10 mrg 378: used in both single-user and multi-user environments
379: .It Sy /stand/
1.1 cgd 380: programs used in a standalone environment
1.17 fair 381: .It Sy /tmp/
1.1 cgd 382: temporary files, usually a
383: .Xr mfs 8
1.45 lukem 384: memory-based filesystem (the contents of
385: .Pa /tmp
386: are usually
387: .Em not
388: preserved across a system reboot)
1.10 mrg 389: .It Sy /usr/
390: contains the majority of the system utilities and files
1.1 cgd 391: .Pp
392: .Bl -tag -width "libdata/" -compact
1.10 mrg 393: .It Sy X11R6/
394: X11 files
395: .Pp
396: .Bl -tag -width "include/" -compact
397: .It Sy bin/
398: X11 binaries
399: .It Sy include/
400: X11 include files
401: .It Sy lib/
402: X11 libraries
403: .El
404: .Pp
405: .It Sy bin/
1.17 fair 406: common utilities, programming tools, and applications
1.10 mrg 407: .It Sy games/
408: the important stuff
409: .It Sy include/
1.1 cgd 410: standard C include files
411: .Pp
1.71 wiz 412: .Bl -tag -width "protocols/" -compact
1.10 mrg 413: .It Sy arpa/
414: include files for Internet service protocols
1.77 jmmv 415: .It Sy atf/
416: include files for the Automated Testing Framework; see
417: .Xr atf 1
1.10 mrg 418: .It Sy g++/
419: include files for the C++ compiler
420: .It Sy machine/
421: machine specific include files
422: .It Sy net/
423: .It Sy netatalk/
1.9 hubertf 424: C include files for AppleTalk protocols
1.11 hubertf 425: miscellaneous network include files;
426: see
427: .Xr atalk 4
1.10 mrg 428: .It Sy netinet/
429: include files for Internet standard protocols; see
1.1 cgd 430: .Xr inet 4
1.20 itojun 431: .It Sy netinet6/
432: include files for Internet protocol version 6; see
433: .Xr inet6 4
1.10 mrg 434: .It Sy netiso/
435: include files for ISO standard protocols; see
1.1 cgd 436: .Xr iso 4
1.20 itojun 437: .It Sy netkey/
438: include files for secret key management, used for security protocols; see
439: .Xr ipsec 4
1.55 perry 440: .It Sy netnatm/
1.9 hubertf 441: C include files for native mode ATM
1.10 mrg 442: .It Sy nfs/
1.1 cgd 443: C include files for NFS (Network File System)
1.10 mrg 444: .It Sy protocols/
1.1 cgd 445: C include files for Berkeley service protocols
1.10 mrg 446: .It Sy sys/
1.1 cgd 447: system C include files (kernel data structures)
1.10 mrg 448: .It Sy ufs/
1.1 cgd 449: C include files for UFS (The U-word File System)
450: .El
451: .Pp
1.10 mrg 452: .It Sy lib/
1.55 perry 453: archive, profiled, position independent archive, and shared libraries
1.10 mrg 454: .It Sy libdata/
455: miscellaneous utility data files
456: .It Sy libexec/
1.39 ross 457: system daemons \*[Am] system utilities (executed by other programs)
1.10 mrg 458: .Pp
459: .Bl -tag -width "uucp/" -compact
460: .It Sy uucp/
461: UUCP binaries and scripts (historically placed; to be moved)
462: .El
463: .Pp
1.52 perry 464: .It Sy lkm/
465: loadable kernel modules
1.10 mrg 466: .It Sy mdec/
1.8 perry 467: boot blocks, etc.
1.55 perry 468: .It Sy obj/
469: architecture-specific target tree produced by building the
470: .Pa /usr/src
471: tree; normally a symbolic link or mounted filesystem
1.14 hubertf 472: .It Sy pkg/
1.18 perry 473: packages maintained by groups other than the
474: .Nx
475: Project.
1.14 hubertf 476: .Pp
477: .Bl -tag -width "include/" -compact
478: .It Sy bin/
479: contributed binaries
480: .It Sy include/
481: contributed include files
1.55 perry 482: .It Sy lib/
483: contributed libraries
484: .It Sy libdata/
485: contributed data files
1.14 hubertf 486: .It Sy libexec/
487: contributed daemons
1.55 perry 488: .It Sy sbin/
489: contributed system utilities
1.14 hubertf 490: .El
491: .Pp
492: .It Sy pkgsrc/
1.15 fair 493: build descriptions ("packages") for the
494: .Nx
495: packages system.
1.14 hubertf 496: .Pp
1.68 jmmv 497: .Bl -tag -width "distfilesX" -compact
498: .It Sy distfiles/
1.14 hubertf 499: Where unchanged source archives are fetched to/stored
1.68 jmmv 500: .It Sy packages/
1.14 hubertf 501: Where compiled binary packages are stored
502: .El
503: .Pp
504: There are also several other subdirectories which contain packages of
1.61 snj 505: a certain category, e.g., archivers, graphics, ...
1.14 hubertf 506: .Pp
1.10 mrg 507: .It Sy sbin/
508: system daemons and system utilities (normally executed by the super-user)
509: .It Sy share/
510: architecture-independent text files
1.1 cgd 511: .Pp
512: .Bl -tag -width "calendar/" -compact
1.10 mrg 513: .It Sy calendar/
514: a variety of calendar files; see
1.1 cgd 515: .Xr calendar 1
1.10 mrg 516: .It Sy dict/
1.1 cgd 517: word lists;
518: see
519: .Xr look 1
1.10 mrg 520: and
521: .Xr spell 1
1.1 cgd 522: .Pp
1.10 mrg 523: .Bl -tag -width "special/" -compact
524: .It Sy words
1.1 cgd 525: common words
1.10 mrg 526: .It Sy web2
527: words of Webster's 2nd International
528: .It Sy papers/
1.1 cgd 529: reference databases;
530: see
531: .Xr refer 1
1.10 mrg 532: .It Sy special/
1.1 cgd 533: custom word lists;
534: see
535: .Xr spell 1
536: .El
537: .Pp
1.10 mrg 538: .It Sy doc/
539: miscellaneous documentation; source for most of the printed
1.5 jtc 540: .Bx 4.3
1.1 cgd 541: manuals (available
542: from the
543: .Tn USENIX
544: association)
1.10 mrg 545: .It Sy games/
546: text files used by various games
1.66 yamt 547: .It Sy i18n/
548: internationalization databases; see
549: .Xr iconv 3
1.10 mrg 550: .It Sy lkm/
1.9 hubertf 551: documentation on the loadable kernel modules interface
1.66 yamt 552: .It Sy locale/
553: locale databases and gettext message catalogs; see
554: .Xr setlocale 3
555: and
556: .Xr gettext 3
1.10 mrg 557: .It Sy man/
1.17 fair 558: formatted manual pages
1.10 mrg 559: .It Sy me/
560: macros for use with the
561: .Xr me 7
562: macro package
563: .It Sy misc/
564: miscellaneous system-wide text files
1.9 hubertf 565: .Pp
1.10 mrg 566: .Bl -tag -width "termcap" -compact
567: .It Sy termcap
1.1 cgd 568: terminal characteristics database;
569: see
570: .Xr termcap 5
571: .El
1.9 hubertf 572: .Pp
1.10 mrg 573: .It Sy mk/
574: include files for
1.1 cgd 575: .Xr make 1
1.10 mrg 576: .It Sy ms/
577: macros for use with the
578: .Xr ms 7
579: macro package
1.66 yamt 580: .It Sy nls/
581: message catalogs; see
582: .Xr catgets 3
1.10 mrg 583: .It Sy skel/
584: sample initialization files for new user accounts
585: .It Sy tabset/
1.17 fair 586: tab description files for a variety of terminals, used in
1.1 cgd 587: the termcap file;
588: see
589: .Xr termcap 5
1.10 mrg 590: .It Sy tmac/
1.1 cgd 591: text processing macros;
592: see
593: .Xr nroff 1
1.17 fair 594: and
1.1 cgd 595: .Xr troff 1
1.10 mrg 596: .It Sy zoneinfo/
1.1 cgd 597: timezone configuration information;
598: see
599: .Xr tzfile 5
600: .El
1.78 jmmv 601: .It Sy tests/
602: test programs; see
603: .Xr atf-run 1
604: for information on how to run them
1.10 mrg 605: .El
1.1 cgd 606: .Pp
1.10 mrg 607: .It Sy /usr/src/
1.29 lukem 608: .Nx
1.10 mrg 609: and local source files
610: .Pp
611: .Bl -tag -width "domestic/" -compact
612: .It Sy bin/
613: source for utilities/files in
1.17 fair 614: .Pa /bin
1.70 wiz 615: .It Sy common/
616: sources shared between kernel and userland
1.29 lukem 617: .It Sy crypto/
618: cryptographic source, which may have import or export restrictions
619: .It Sy dist/
620: third-party
621: .Sq virgin
622: source code, referenced by other parts of the source tree
1.55 perry 623: .It Sy distrib/
624: tools and data-files for making distributions
625: .It Sy doc/
1.61 snj 626: documentation about the source tree (i.e., about the tree, not about
1.55 perry 627: how to use the built software.)
1.10 mrg 628: .It Sy etc/
629: source (usually example files) for files in
630: .Pa /etc
1.81 ! lukem 631: .It Sy external/
! 632: source for programs from external third parties
! 633: (where
! 634: .Nx
! 635: is the not the primary maintainer),
! 636: grouped by license, and then products per license
! 637: .Pp
! 638: .Bl -tag -width "bsd/" -compact
! 639: .It Sy bsd/
! 640: BSD (or equivalent) licensed software,
! 641: possibly with the
! 642: .Dq advertising clause
! 643: .El
! 644: .Pp
1.10 mrg 645: .It Sy games/
646: source for utilities/files in
647: .Pa /usr/games
1.29 lukem 648: .It Sy gnu/
649: source for programs covered by the
650: .Tn GNU
651: license (or similar)
1.10 mrg 652: .It Sy include/
653: source for files in
654: .Pa /usr/include
655: .It Sy lib/
656: source for libraries in
657: .Pa /usr/lib
658: .It Sy libexec/
659: source for utilities/files in
660: .Pa /usr/libexec
1.29 lukem 661: .It Sy regress/
662: various regression tests
1.55 perry 663: .It Sy rescue/
664: source/makefiles for /rescue
1.10 mrg 665: .It Sy sbin/
666: source for utilities/files in
667: .Pa /sbin
668: .It Sy share/
669: source for files in
670: .Pa /usr/share
671: .Pp
672: .Bl -tag -width "doc/" -compact
673: .It Sy doc/
674: .Pp
675: .Bl -tag -width "papers/" -compact
676: .It Sy papers/
677: source for various Berkeley technical papers
678: .It Sy psd/
679: source for Programmer's Supplementary Documents
680: .It Sy smm/
681: source for System Manager's Manual
682: .It Sy usd/
683: source for User's Supplementary Documents
684: .Pp
685: .El
686: .El
687: .It Sy sys/
688: kernel source files
689: .Pp
690: .Bl -tag -width "gdbscripts/" -compact
691: .It Sy arch/
1.40 pooka 692: architecture-specific support
1.10 mrg 693: .Pp
1.40 pooka 694: .Bl -tag -width "playstation2/" -compact
1.43 bjh21 695: .It Sy acorn26/
1.69 tsutsui 696: Acorn Archimedes, A-series and R-series systems
1.37 bjh21 697: .It Sy acorn32/
1.69 tsutsui 698: Acorn RiscPC/A7000 and VLSI RC7500
1.40 pooka 699: .It Sy algor/
1.69 tsutsui 700: Algorithmics Ltd. MIPS evaluations boards
1.10 mrg 701: .It Sy alpha/
1.69 tsutsui 702: Digital/Compaq Alpha
1.61 snj 703: .It Sy amd64/
1.69 tsutsui 704: Computers with x86_64 capable CPUs
1.10 mrg 705: .It Sy amiga/
1.69 tsutsui 706: Commodore Amiga and MacroSystem DraCo
1.29 lukem 707: .It Sy amigappc/
1.69 tsutsui 708: PowerPC based Amiga boards
1.23 soda 709: .It Sy arc/
1.69 tsutsui 710: MIPS-based machines following the Advanced RISC Computing spec
1.40 pooka 711: .It Sy arm/
712: ARM processor general support
1.10 mrg 713: .It Sy atari/
1.69 tsutsui 714: Atari TT030, Falcon and Hades
1.10 mrg 715: .It Sy bebox/
1.69 tsutsui 716: Be Inc. BeBox
1.40 pooka 717: .It Sy cats/
1.69 tsutsui 718: Chalice Technology's CATS and Intel's EBSA-285 evaluation boards
1.40 pooka 719: .It Sy cesfic/
720: CES FIC8234 VME processor board
1.26 soren 721: .It Sy cobalt/
1.69 tsutsui 722: Cobalt Networks' MIPS-based Microserver
1.31 itojun 723: .It Sy dreamcast/
1.40 pooka 724: Sega Dreamcast game console
1.42 simonb 725: .It Sy evbarm/
726: ARM based evaluation boards
727: .It Sy evbmips/
728: MIPS based evaluation boards
1.47 scw 729: .It Sy evbppc/
1.69 tsutsui 730: PowerPC based evaluation boards and appliances
1.29 lukem 731: .It Sy evbsh3/
1.69 tsutsui 732: SH3/SH4 based evaluation boards
733: .It Sy ews4800mips/
734: NEC's MIPS based EWS4800 workstations
1.10 mrg 735: .It Sy hp300/
1.69 tsutsui 736: Hewlett-Packard 9000/300 and 400 680x0-based workstations
737: .It Sy hp700/
738: Hewlett-Packard 9000/700 HPPA based workstations
1.65 snj 739: .It Sy hpcarm/
1.69 tsutsui 740: StrongARM based WinCE PDA machines
1.29 lukem 741: .It Sy hpcmips/
1.69 tsutsui 742: MIPS based WinCE PDA machines
1.31 itojun 743: .It Sy hpcsh/
1.69 tsutsui 744: Hitachi SH3/4 based WinCE PDA machines
745: .It Sy hppa/
746: HPPA processor general support
1.10 mrg 747: .It Sy i386/
1.69 tsutsui 748: 80x86-based IBM PCs and clones
749: .It Sy ibmnws/
750: IBM Network Station 1000
1.64 gavan 751: .It Sy iyonix/
1.69 tsutsui 752: Castle Technology's Iyonix ARM based PCs
1.29 lukem 753: .It Sy luna68k/
1.69 tsutsui 754: Omron Tateishi Electric's 680x0-based LUNA workstations
1.10 mrg 755: .It Sy m68k/
1.69 tsutsui 756: 680x0 processor general support
1.10 mrg 757: .It Sy mac68k/
1.69 tsutsui 758: Apple Macintosh with 68k CPU
1.29 lukem 759: .It Sy macppc/
1.69 tsutsui 760: Apple Power Macintosh and clones
1.10 mrg 761: .It Sy mips/
1.69 tsutsui 762: MIPS processor general support
1.28 wdk 763: .It Sy mipsco/
1.69 tsutsui 764: MIPS Computer Systems Inc. family of workstations and servers
1.29 lukem 765: .It Sy mmeye/
1.40 pooka 766: Brains Inc. SH3 based mmEye multimedia server
1.10 mrg 767: .It Sy mvme68k/
1.69 tsutsui 768: Motorola MVME 680x0-based SBCs
769: .It Sy mvmeppc/
770: Motorola PowerPC VME SBCs
771: .It Sy netwinder/
772: StrongARM based NetWinder machines
1.29 lukem 773: .It Sy news68k/
1.69 tsutsui 774: Sony's 680x0-based NEWS workstations
1.29 lukem 775: .It Sy newsmips/
1.69 tsutsui 776: Sony's MIPS-based NEWS workstations
1.29 lukem 777: .It Sy next68k/
1.69 tsutsui 778: NeXT 68k "black" hardware
1.29 lukem 779: .It Sy ofppc/
1.40 pooka 780: Open Firmware PowerPC workstations
1.36 uch 781: .It Sy playstation2/
1.40 pooka 782: SONY PlayStation 2
1.10 mrg 783: .It Sy pmax/
1.69 tsutsui 784: Digital MIPS-based DECstations and DECsystems
1.10 mrg 785: .It Sy powerpc/
1.40 pooka 786: PowerPC processor support
1.29 lukem 787: .It Sy prep/
1.69 tsutsui 788: PReP (PowerPC Reference Platform) and CHRP machines
1.40 pooka 789: .It Sy sandpoint/
790: Motorola Sandpoint reference platform
1.41 simonb 791: .It Sy sbmips/
1.69 tsutsui 792: Broadcom/SiByte evaluation boards
1.26 soren 793: .It Sy sgimips/
1.69 tsutsui 794: Silicon Graphics' MIPS-based workstations
1.29 lukem 795: .It Sy sh3/
1.69 tsutsui 796: SH3/SH4 processor general support
1.40 pooka 797: .It Sy shark/
1.69 tsutsui 798: Digital DNARD ("Shark")
1.10 mrg 799: .It Sy sparc/
1.69 tsutsui 800: Sun Microsystems SPARC (32-bit) and UltraSPARC (in 32-bit mode)
1.29 lukem 801: .It Sy sparc64/
1.69 tsutsui 802: Sun Microsystems UltraSPARC (in native 64-bit mode)
1.40 pooka 803: .It Sy sun2/
804: Sun Microsystems 68010-based Sun 2 architecture
1.10 mrg 805: .It Sy sun3/
1.40 pooka 806: Sun Microsystems 68020/68030-based Sun 3/3x architecture
807: .It Sy sun68k/
808: 680x0-based Sun architecture general support
1.10 mrg 809: .It Sy vax/
1.69 tsutsui 810: Digital VAX
1.10 mrg 811: .It Sy x68k/
1.40 pooka 812: Sharp X680x0 680x0-based workstations
1.69 tsutsui 813: .It Sy x86/
814: General support for PC/AT compatibles with ia32 or x86_64 CPUs
815: .It Sy xen/
816: The Xen virtual machine monitor
1.74 ober 817: .It Sy zaurus/
818: Sharp C3x00 Arm based PDA
1.70 wiz 819: .El
1.10 mrg 820: .Pp
821: .It Sy compat/
822: kernel compatibility modules directory
823: .Pp
824: .Bl -tag -width "ossaudio/" -compact
825: .It Sy common/
826: common compatibility routines, old
827: .Bx 4
828: and
829: .Nx
830: routines.
831: .It Sy freebsd/
1.13 perry 832: support for
833: .Fx
834: binaries; see
1.10 mrg 835: .Xr compat_freebsd 8
836: .It Sy hpux/
837: support for 68000 HP-UX binaries
838: .It Sy ibcs2/
839: support for Intel Binary binaries
840: .It Sy linux/
841: support for Linux binaries; see
842: .Xr compat_linux 8
843: .It Sy m68k4k/
1.55 perry 844: support for 4KB page 68000 binaries
1.29 lukem 845: .It Sy netbsd32/
1.35 wiz 846: support for
847: .Nx
848: 32-bit binaries on 64 bit platforms with compatible CPU families
1.10 mrg 849: .It Sy osf1/
1.16 fair 850: support for
851: .Tn Digital
852: .Ux
853: .Po
854: formerly
855: .Tn OSF/1
856: .Pc
857: binaries
1.10 mrg 858: .It Sy ossaudio/
859: support for OSS audio
1.29 lukem 860: .It Sy pecoff/
861: support for
862: .Tn Win32
863: binaries; see
864: .Xr compat_pecoff 8
1.10 mrg 865: .It Sy sunos/
1.16 fair 866: support for
867: .Tn SunOS 4.x
868: binaries; see
1.10 mrg 869: .Xr compat_sunos 8
870: .It Sy svr4/
871: support for System V Release 4 binaries; see
872: .Xr compat_svr4 8
873: .It Sy ultrix/
1.16 fair 874: support for
1.53 wiz 875: .Tn ULTRIX
1.16 fair 876: binaries
1.29 lukem 877: .It Sy vax1k/
1.51 wiz 878: support for older VAX binaries that started on a 1 KB boundary
1.10 mrg 879: .El
880: .Pp
881: .It Sy conf/
882: architecture independent configuration directory
1.29 lukem 883: .It Sy crypto/
884: cryptographic kernel source, which may have import or export restrictions
1.10 mrg 885: .It Sy ddb/
886: in kernel debugger
887: .It Sy dev/
888: architecture independent device support
1.55 perry 889: .It Sy fs/
890: miscellaneous file systems
891: .Bl -tag -width "filecorefs/" -compact
892: .It Sy adosfs/
893: AmigaDOS file-system support; see
894: .Xr mount_ados 8
895: .It Sy cd9660/
896: support for the ISO-9660 filesystem; see
897: .Xr mount_cd9660 8
1.29 lukem 898: .It Sy filecorefs/
899: support for the Acorn RISC OS filecore filesystem; see
900: .Xr mount_filecore 8
1.55 perry 901: .It Sy msdosfs/
902: .Tn MS-DOS
903: file system; see
904: .Xr mount_msdos 8
905: .It Sy ntfs/
906: NTFS filesystem support; see
907: .Xr mount_ntfs 8
1.67 jmmv 908: .It Sy ptyfs/
909: pseudo-terminal device filesystem; see
910: .Xr mount_ptyfs 8
1.68 jmmv 911: .It Sy smbfs/
1.55 perry 912: SMB/CIFS filesystem support; see
913: .Xr mount_smbfs 8
914: .It Sy union/
915: union file system; see
916: .Xr mount_union 8
917: .El
1.10 mrg 918: .It Sy gdbscripts/
919: support for accessing kernel structures from within the debugger
920: .Xr gdb 1 .
921: .It Sy ipkdb/
922: support for kernel debugging over the network
923: .Pp
924: .It Sy kern/
925: support for the high kernel (system calls)
926: .It Sy lib/
927: kernel libraries
928: .Pp
929: .Bl -tag -width "libkern/" -compact
930: .It Sy libkern/
931: C library routines used in the kernel
932: .It Sy libsa/
1.55 perry 933: machine independent stand alone kernel library
1.10 mrg 934: .It Sy libz/
935: compression library
936: .El
937: .Pp
938: .It Sy lkm/
939: loadable kernel modules
940: .Pp
1.29 lukem 941: .Bl -tag -width "gdbscripts/" -compact
1.10 mrg 942: .It Sy compat/
943: LKM support compatibility modules; currently unsupported.
944: .It Sy netinet/
945: LKM support networking modules
946: .Pp
947: .Bl -tag -width "if_ipl/" -compact
948: .It Sy if_ipl/
949: LKM for IP-Filter
950: .El
951: .Pp
952: .It Sy vfs/
953: LKM support for file systems.
954: .El
955: .Pp
956: .It Sy miscfs/
957: miscellaneous file systems
958: .Pp
959: .Bl -tag -width "deadfs/" -compact
960: .It Sy deadfs/
961: kernel only dead file system
962: .It Sy fdesc/
963: file descriptor file system; see
964: .Xr mount_fdesc 8
965: .It Sy fifofs/
966: POSIX FIFO support
967: .It Sy genfs/
968: kernel only generic file system
969: .It Sy kernfs/
970: kernel namespace file system; see
971: .Xr mount_kernfs 8
972: .It Sy nullfs/
973: loop back file system; see
974: .Xr mount_null 8
1.29 lukem 975: .It Sy overlay/
976: overlay file system; see
977: .Xr mount_overlay 8
1.10 mrg 978: .It Sy portal/
979: portal file system; see
980: .Xr mount_portal 8
981: .It Sy procfs/
982: process file system; see
983: .Xr mount_procfs 8
984: .It Sy specfs/
985: kernel only special file system
1.29 lukem 986: .It Sy syncfs/
987: kernel trickle sync algorithm
1.10 mrg 988: .It Sy umapfs/
989: user and group re-mapping file system; see
990: .Xr mount_umap 8
991: .El
992: .Pp
993: .It Sy net/
994: miscellaneous networking support
1.29 lukem 995: .It Sy netatalk/
996: AppleTalk networking support
1.10 mrg 997: .It Sy netinet/
1.29 lukem 998: IP networking support
999: .It Sy netinet6/
1000: IPv6 networking support
1.10 mrg 1001: .It Sy netiso/
1.29 lukem 1002: ISO networking support
1003: .It Sy netkey/
1004: Key database for IPsec networking support
1.10 mrg 1005: .It Sy netnatm/
1006: ATM networking support
1007: .It Sy nfs/
1008: NFS support
1009: .It Sy stand/
1010: kernel standalone support
1011: .It Sy sys/
1012: kernel (and system) include files
1013: .It Sy ufs/
1014: local filesystem support
1015: .Pp
1016: .Bl -tag -width "ffs/" -compact
1017: .It Sy ffs/
1018: the Berkeley Fast File System
1019: .It Sy lfs/
1020: the log-structured file system
1021: .It Sy mfs/
1022: the in-memory file system
1023: .It Sy ufs/
1.16 fair 1024: shared
1025: .Ux
1026: file system support
1.10 mrg 1027: .El
1.29 lukem 1028: .It Sy uvm/
1029: UVM virtual memory system
1.10 mrg 1030: .El
1.78 jmmv 1031: .It Sy tests/
1032: source for test programs in
1033: .Pa /usr/tests
1.10 mrg 1034: .It Sy usr.bin/
1035: source for utilities/files in
1036: .Pa /usr/bin
1037: .It Sy usr.sbin/
1038: source for utilities/files in
1039: .Pa /usr/sbin
1.1 cgd 1040: .El
1.10 mrg 1041: .It Sy /var/
1.1 cgd 1042: multi-purpose log, temporary, transient, and spool files
1043: .Pp
1044: .Bl -tag -width "preserve/" -compact
1.17 fair 1045: .It Sy account/
1.1 cgd 1046: system accounting files
1047: .Pp
1.10 mrg 1048: .Bl -tag -width "acct" -compact
1049: .It Sy acct
1.1 cgd 1050: execution accounting file;
1051: see
1052: .Xr acct 5
1053: .El
1054: .Pp
1.10 mrg 1055: .It Sy at/
1.1 cgd 1056: timed command scheduling files;
1057: see
1.17 fair 1058: .Xr at 1
1.10 mrg 1059: .It Sy backups/
1060: miscellaneous backup files, largely of files found in
1061: .Pa /etc
1.34 lukem 1062: .It Sy chroot/
1063: home directories of applications which are run in a
1064: .Xr chroot 8
1065: .Dq cage .
1.10 mrg 1066: .It Sy crash/
1067: system crash dumps; see
1068: .Xr savecore 8
1.29 lukem 1069: .It Sy cron/
1070: scheduled commands configuration files; see
1071: .Xr cron 8
1.17 fair 1072: .It Sy db/
1.59 agc 1073: miscellaneous automatically generated system-specific database files,
1074: and persistent files used in the maintenance of third party software.
1075: .Pp
1076: .Bl -tag -width "monthly.out" -compact
1077: .It Sy pkg
1078: default location for metadata related to third party software
1079: packages.
1.60 wiz 1080: See
1.59 agc 1081: .Xr pkg_install 1
1.60 wiz 1082: for more details of the
1083: .Nx
1084: Packages Collection, or pkgsrc.
1.59 agc 1085: .El
1086: .Pp
1.17 fair 1087: .It Sy games/
1.10 mrg 1088: miscellaneous game status and log files
1.29 lukem 1089: .It Sy heimdal/
1090: Kerberos 5 KDC database; see
1091: .Xr kdc 8
1.17 fair 1092: .It Sy log/
1.10 mrg 1093: miscellaneous system log files
1094: .Pp
1095: .Bl -tag -width "monthly.out" -compact
1096: .It Sy amd.*
1097: .Xr amd 8
1098: logs
1099: .It Sy daily.out
1100: output of the last run of the
1101: .Pa /etc/daily
1102: script
1103: .It Sy ftp.*
1104: .Xr ftp 1
1105: logs
1106: .It Sy kerberos.*
1.33 wiz 1107: .Xr kerberos 8
1.10 mrg 1108: logs
1109: .It Sy lastlog
1.17 fair 1110: system last time logged in log; see
1.10 mrg 1111: .Xr utmp 5
1112: .It Sy lpd-errs.*
1113: printer daemon error logs; see
1114: .Xr lpd 8
1115: .It Sy maillog.*
1116: .Xr sendmail 8
1117: log files
1118: .It Sy messages.*
1119: general system information log
1120: .It Sy monthly.out
1121: output of the last run of the
1122: .Pa /etc/monthly
1123: script
1124: .It Sy secure
1125: sensitive security information log
1126: .It Sy sendmail.st
1127: .Xr sendmail 8
1128: statistics
1129: .It Sy timed.*
1130: .Xr timed 8
1131: logs
1132: .It Sy weekly.out
1133: output of the last run of the
1134: .Pa /etc/weekly
1135: script
1136: .It Sy wtmp
1.1 cgd 1137: login/logout log;
1138: see
1.10 mrg 1139: .Xr utmp 5
1.1 cgd 1140: .El
1141: .Pp
1.17 fair 1142: .It Sy mail/
1.10 mrg 1143: user system mailboxes
1144: .It Sy msgs/
1145: system messages; see
1146: .Xr msgs 1
1.17 fair 1147: .\" since we use nvi (now called vi) this isn't the place any more, is it?
1.10 mrg 1148: .It Sy preserve/
1149: temporary home of files preserved after an accidental death of
1150: .Xr ex 1
1151: or
1152: .Xr vi 1
1.17 fair 1153: .It Sy quotas/
1.10 mrg 1154: filesystem quota information
1155: .It Sy run/
1156: system information files, rebuilt after each reboot
1157: .Pp
1158: .Bl -tag -width "utmp" -compact
1159: .It Sy utmp
1160: database of current users; see
1.1 cgd 1161: .Xr utmp 5
1162: .El
1163: .Pp
1.17 fair 1164: .It Sy rwho/
1.10 mrg 1165: rwho data files; see
1.1 cgd 1166: .Xr rwhod 8 ,
1167: .Xr rwho 1 ,
1168: and
1169: .Xr ruptime 1
1.17 fair 1170: .It Sy spool/
1.10 mrg 1171: miscellaneous printer and mail system spooling directories
1.1 cgd 1172: .Pp
1.10 mrg 1173: .Bl -tag -width "uucppublic/" -compact
1.17 fair 1174: .It Sy ftp/
1.10 mrg 1175: commonly
1176: .Dq ~ftp ,
1177: the anonymous ftp root directory; see
1.9 hubertf 1178: .Xr ftpd 8
1.17 fair 1179: .It Sy mqueue/
1.55 perry 1180: sendmail mail queue;
1.1 cgd 1181: see
1182: .Xr sendmail 8
1.10 mrg 1183: .It Sy news/
1184: Network news archival and spooling directories
1185: .It Sy output/
1186: printer spooling directories
1.55 perry 1187: .It Sy postfix/
1188: postfix mail queue;
1189: see
1190: .Xr postfix 1
1.17 fair 1191: .It Sy uucp/
1.1 cgd 1192: uucp spool directory
1.10 mrg 1193: .It Sy uucppublic/
1194: commonly
1195: .Dq ~uucp ,
1196: the uucp public temporary directory; see
1197: .Xr uucp 1
1.1 cgd 1198: .El
1199: .Pp
1.17 fair 1200: .It Sy tmp/
1.10 mrg 1201: temporary files that are not discarded between system reboots
1202: .Pp
1203: .Bl -tag -width "vi.recover/" -compact
1204: .It Sy vi.recover/
1.17 fair 1205: recovery directory for new
1206: .Xr vi 1
1.10 mrg 1207: .El
1.46 grant 1208: .Pp
1.29 lukem 1209: .It Sy yp/
1210: Databases and configuration for the NIS (YP) system; see
1211: .Xr nis 8 .
1.1 cgd 1212: .El
1213: .El
1214: .Sh SEE ALSO
1.10 mrg 1215: .Xr apropos 1 ,
1.17 fair 1216: .Xr ls 1 ,
1.1 cgd 1217: .Xr whatis 1 ,
1218: .Xr whereis 1 ,
1.56 wiz 1219: .Xr which 1
1.1 cgd 1220: .Sh HISTORY
1221: A
1.17 fair 1222: .Nm
1.1 cgd 1223: manual page appeared in
1224: .At v7 .
CVSweb <webmaster@jp.NetBSD.org>