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