[csw-devel] SF.net SVN: gar:[20998] csw/mgar/pkg/opencsw-manual/trunk/files/ for-maintainers/filesystem-layout.rst

[wahwah at users.sourceforge.net]

Revision: 20998
          http://gar.svn.sourceforge.net/gar/?rev=20998&view=rev
Author:   wahwah
Date:     2013-05-05 13:48:36 +0000 (Sun, 05 May 2013)
Log Message:
-----------
opencsw-manual/trunk: A little more about FS hierarchy

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/filesystem-layout.rst

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/filesystem-layout.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/filesystem-layout.rst	2013-05-05 12:36:58 UTC (rev 20997)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/filesystem-layout.rst	2013-05-05 13:48:36 UTC (rev 20998)
@@ -7,7 +7,7 @@
 Introduction
 ------------
 
-OpenCSW installs over an already installed Solaris system, and follows the
+OpenCSW installs into an already installed Solaris system, and follows the
 general rule of not conflicting with existing Solaris files.
 
 The outermost installation directories are:
@@ -21,8 +21,27 @@
 In this setup, non-global zones see ``/opt/csw`` as mounted read-only. Any
 local state needs to be kept under ``/var/opt/csw``.
 
+Inside the ``/opt/csw`` prefix, the typical hierarchy rules apply. You can
+consult the Debian `filesystem hierarchy standard`_ for an overview. A short version is:
+
+* Executables go to ``/opt/csw/bin`` ``/opt/csw/sbin`` ``/opt/csw/libexec``
+* Shared libraries go to ``/opt/csw/lib``
+* Architecture-independent files go to ``/opt/csw/share``
+* Documentation goes to ``/opt/csw/shared/doc``
+* Manual pages go to ``/opt/csw/share/man``
+
+What's special about the Solaris directory hierachy, including OpenCSW is the
+possibility to include binaries for multiple architectures in a single package.
+The standard is to create a subdirectory under ``bin`` named after the processor
+architecture name, as returned by the ``isalist`` utility. For example, 32-bit
+binaries might be in ``/opt/csw/bin`` and 64-bit Intel binaries would be in
+``/opt/csw/bin/amd64``.
+
 .. [#shared-opt-csw]
    `Shared /opt/csw configuration files`_
 
 .. _Shared /opt/csw configuration files:
    http://wiki.opencsw.org/shared-opt-csw-setup
+
+.. _filesystem hierarchy standard:
+   http://wiki.debian.org/FilesystemHierarchyStandard

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.