The /usr Hierarchy - Revision history

Apple: /* Requirements */ wikifying the table

2010-11-17T00:18:37Z

‎Requirements: wikifying the table

Drobbins: /* /usr/share/xml : XML data (optional) */

2010-11-08T05:48:23Z

‎/usr/share/xml : XML data (optional)

Drobbins: /* /usr/share/sgml : SGML data (optional) */

2010-11-08T05:48:15Z

‎/usr/share/sgml : SGML data (optional)

Drobbins: /* /usr/share/misc : Miscellaneous architecture-independent data */

2010-11-08T05:48:03Z

‎/usr/share/misc : Miscellaneous architecture-independent data

Drobbins: /* /usr/share/man : Manual pages */

2010-11-08T05:47:51Z

‎/usr/share/man : Manual pages

Drobbins: /* /usr/share/dict : Word lists (optional) */

2010-11-08T05:47:38Z

‎/usr/share/dict : Word lists (optional)

Drobbins: /* /usr/local/share */

2010-11-08T05:47:17Z

‎/usr/local/share

Drobbins: /* /usr/lib : Alternate format libraries (optional) */

2010-11-08T05:46:34Z

‎/usr/lib : Alternate format libraries (optional)

Drobbins: /* /usr/lib(64)/gconv */

2010-11-08T05:46:17Z

‎/usr/lib(64)/gconv

Drobbins: /* /usr/lib(64)/locale */

2010-11-08T05:35:45Z

‎/usr/lib(64)/locale

@@ Line 5: / Line 5: @@
 The following directories, or symbolic links to directories, are required in /usr.
+{| {{Table}}
-Directory	Description
+!Directory
-bin	Most user commands
+!Description
-include	Header files included by C programs
+|-
-lib	Libraries
+|bin
-local	Local hierarchy (empty after main installation)
+|Most user commands
-sbin	Non-vital system binaries
+|-
-share	Architecture-independent data
+|include
 == Specific Options ==

@@ Line 305: / Line 305: @@
 Other files that are not specific to a given DTD may reside in their own subdirectory.
-== /usr/share/xml : XML data (optional) ==
+=== /usr/share/xml : XML data (optional) ===
 /usr/share/xml contains architecture-independent files used by XML applications, such as ordinary catalogs (not the centralized ones, see /etc/sgml), DTDs, entities, or style sheets.

@@ Line 290: / Line 290: @@
 Other (application-specific) files may appear here, but a distributor may place them in /usr/lib at their discretion. <ref>Some such files include: airport, birthtoken, eqnchar, getopt, gprof.callg, gprof.flat, inter.phone, ipfw.samp.filters, ipfw.samp.scripts, keycap.pcvt, mail.help, mail.tildehelp, man.template, map3270, mdoc.template, more.help, na.phone, nslookup.help, operator, scsi_modes, sendmail.hf, style, units.lib, vgrindefs, vgrindefs.db, zipcodes</ref>
-== /usr/share/sgml : SGML data (optional) ==
+=== /usr/share/sgml : SGML data (optional) ===
 /usr/share/sgml contains architecture-independent files used by SGML applications, such as ordinary catalogs (not the centralized ones, see /etc/sgml), DTDs, entities, or style sheets.
@@ Line 304: / Line 304: @@
 Other files that are not specific to a given DTD may reside in their own subdirectory.
 == /usr/share/xml : XML data (optional) ==

@@ Line 275: / Line 275: @@
 The practice of placing various language manual pages in appropriate subdirectories of /usr/share/man also applies to the other manual page hierarchies, such as /usr/local/man and /usr/X11R6/man. (This portion of the standard also applies later in the section on the optional /var/cache/man structure.)
-== /usr/share/misc : Miscellaneous architecture-independent data ==
+=== /usr/share/misc : Miscellaneous architecture-independent data ===
 This directory contains miscellaneous architecture-independent files which don't require a separate subdirectory under /usr/share.
@@ Line 289: / Line 289: @@
 Other (application-specific) files may appear here, but a distributor may place them in /usr/lib at their discretion. <ref>Some such files include: airport, birthtoken, eqnchar, getopt, gprof.callg, gprof.flat, inter.phone, ipfw.samp.filters, ipfw.samp.scripts, keycap.pcvt, mail.help, mail.tildehelp, man.template, map3270, mdoc.template, more.help, na.phone, nslookup.help, operator, scsi_modes, sendmail.hf, style, units.lib, vgrindefs, vgrindefs.db, zipcodes</ref>
 == /usr/share/sgml : SGML data (optional) ==

@@ Line 194: / Line 194: @@
 Other word lists must be included here, if present.
-== /usr/share/man : Manual pages ==
+=== /usr/share/man : Manual pages ===
 This section details the organization for manual pages throughout the system, including /usr/share/man. Also refer to the section on /var/cache/man.

@@ Line 173: / Line 173: @@
 It is recommended that application-specific, architecture-independent directories be placed here. Such directories include groff, perl, ghostscript, texmf, and kbd (Linux) or syscons (BSD). They may, however, be placed in /usr/lib for backwards compatibility, at the distributor's discretion. Similarly, a /usr/lib/games hierarchy may be used in addition to the /usr/share/games hierarchy if the distributor wishes to place some game data there.
-== /usr/share/dict : Word lists (optional) ==
+=== /usr/share/dict : Word lists (optional) ===
 This directory is the home for word lists on the system; Traditionally this directory contains only the English words file, which is used by look(1) and various spelling programs. words may use either American or British spelling.
@@ Line 193: / Line 193: @@
 Other word lists must be included here, if present.
 == /usr/share/man : Manual pages ==

← Older revision		Revision as of 05:47, 8 November 2010
Line 126:		Line 126:
	: Local source code		: Local source code

−	~~== /usr/local/share ==~~
−
−	The requirements for the contents of this directory are the same as /usr/share. The only additional constraint is that /usr/local/share/man and /usr/local/man directories must be synonomous (usually this means that one of them must be a symbolic link). <ref>/usr/local/man may be deprecated in future FHS releases, so if all else is equal, making that one a symlink seems sensible.</ref>
	== /usr/sbin : Non-essential standard system binaries ==		== /usr/sbin : Non-essential standard system binaries ==

← Older revision		Revision as of 05:46, 8 November 2010
Line 99:		Line 99:
	For historical reasons, /usr/lib/sendmail must be a symbolic link to /usr/sbin/sendmail if the latter exists. <ref>Some executable commands such as makewhatis and sendmail have also been traditionally placed in /usr/lib. makewhatis is an internal binary and must be placed in a binary directory; users access only catman. Newer sendmail binaries are now placed by default in /usr/sbin. Additionally, systems using a sendmail-compatible mail transfer agent must provide /usr/sbin/sendmail as a symbolic link to the appropriate executable.</ref>		For historical reasons, /usr/lib/sendmail must be a symbolic link to /usr/sbin/sendmail if the latter exists. <ref>Some executable commands such as makewhatis and sendmail have also been traditionally placed in /usr/lib. makewhatis is an internal binary and must be placed in a binary directory; users access only catman. Newer sendmail binaries are now placed by default in /usr/sbin. Additionally, systems using a sendmail-compatible mail transfer agent must provide /usr/sbin/sendmail as a symbolic link to the appropriate executable.</ref>

−	~~==/usr/lib<qual> : Alternate format libraries (optional) ==~~
−
−	/usr/lib<qual> performs the same role as /usr/lib for an alternate binary format, except that the symbolic links /usr/lib<qual>/sendmail and /usr/lib<qual>/X11 are not required. <ref>The case where /usr/lib and /usr/lib<qual> are the same (one is a symbolic link to the other) these files and the per-application subdirectories will exist.</ref>
	== /usr/local : Local hierarchy ==		== /usr/local : Local hierarchy ==

@@ Line 91: / Line 91: @@
 The /usr/lib/locale directory contains runtime locale data that is used directly by programs, and is generated by the locale-gen command. This command uses settings in /etc/locale.gen to determine what runtime locale data to generate. The data in /usr/lib/locale can always be regenerated using locale-gen, assuming that the source files in /usr/share/locale still exist. Therefore, it's recommended that future versions of Funtoo Linux reconfigure glibc to move this data to /var/lib/locale or /var/cache/locale instead.
-=== /usr/lib(64)/gconv ===
+=== /usr/lib/gconv ===
 === Specific Options ===

@@ Line 87: / Line 87: @@
 Applications may use a single subdirectory under /usr/lib. If an application uses a subdirectory, all architecture-dependent data exclusively used by the application must be placed within that subdirectory. <ref>For example, the perl5 subdirectory for Perl 5 modules and libraries.</ref>
-=== /usr/lib(64)/locale ===
+=== /usr/lib/locale ===
 === /usr/lib(64)/gconv ===