[csw-devel] SF.net SVN: gar:[16814] csw/mgar/pkg/opencsw-policy/trunk/files

[wahwah at users.sourceforge.net]

Revision: 16814
          http://gar.svn.sourceforge.net/gar/?rev=16814&view=rev
Author:   wahwah
Date:     2012-01-19 12:59:01 +0000 (Thu, 19 Jan 2012)
Log Message:
-----------
opencsw-policy/trunk: add some empty sections and a reference to the scrapbook

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/index.rst
    csw/mgar/pkg/opencsw-policy/trunk/files/for-developers/index.rst
    csw/mgar/pkg/opencsw-policy/trunk/files/for-maintainers/filesystem-layout.rst

Added Paths:
-----------
    csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/bootstrapping.rst
    csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/configuring-services.rst

Added: csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/bootstrapping.rst
===================================================================
--- csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/bootstrapping.rst	                        (rev 0)
+++ csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/bootstrapping.rst	2012-01-19 12:59:01 UTC (rev 16814)
@@ -0,0 +1,15 @@
+-------------
+Bootstrapping
+-------------
+
+On a Solaris 10 system, you can use the capacity of pkgadd to download
+packages via http::
+
+  pkgadd -d http://get.opencsw.org/now
+
+On Solaris 8 and 9 (best effort support only), you need to download the
+package using e.g. wget and install it with::
+
+  wget http://mirror.opencsw.org/opencsw/pkgutil.pkg
+  pkgadd -d pkgutil.pkg
+

Added: csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/configuring-services.rst
===================================================================
--- csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/configuring-services.rst	                        (rev 0)
+++ csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/configuring-services.rst	2012-01-19 12:59:01 UTC (rev 16814)
@@ -0,0 +1,23 @@
+====================
+Configuring services
+====================
+
+/etc/opt/csw vs. /opt/csw/etc
+=============================
+
+...
+
+preserveconf
+============
+
+...
+
+RC/SMF
+======
+
+...
+
+csw.conf
+========
+
+...

Modified: csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/index.rst	2012-01-19 12:22:05 UTC (rev 16813)
+++ csw/mgar/pkg/opencsw-policy/trunk/files/for-administrators/index.rst	2012-01-19 12:59:01 UTC (rev 16814)
@@ -2,21 +2,15 @@
 OpenCSW for Administrators
 ==========================
 
-A usage manual for people who manage Solaris systems with OpenCSW packages.
+A user's manual for people who manage Solaris systems with OpenCSW packages.
 
-.. contents::
+.. toctree::
+  :maxdepth: 2
 
-Bootstrapping
--------------
+  bootstrapping
+  configuring-services
 
-On a Solaris 10 system, you can use the capacity of pkgadd to download
-packages via http::
-
-  pkgadd -d http://get.opencsw.org/now
-
-On Solaris 8 and 9 (best effort support only), you need to download the
-package using e.g. wget and install it with::
-
-  wget http://mirror.opencsw.org/opencsw/pkgutil.pkg
-  pkgadd -d pkgutil.pkg
-
+.. [#dagosscrapebook]
+   `Dago's Scrapebook`_
+.. _Dago's Scrapebook:
+   http://sourceforge.net/apps/trac/gar/wiki/DagosScrapbook

Modified: csw/mgar/pkg/opencsw-policy/trunk/files/for-developers/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-policy/trunk/files/for-developers/index.rst	2012-01-19 12:22:05 UTC (rev 16813)
+++ csw/mgar/pkg/opencsw-policy/trunk/files/for-developers/index.rst	2012-01-19 12:59:01 UTC (rev 16814)
@@ -1,8 +1,24 @@
-======================
+----------------------
 OpenCSW for Developers
-======================
+----------------------
 
-.. contents::
-
 This is a manual for developers who want to build own software, using
 tools and libraries provided by OpenCSW.
+
+Linking against OpenCSW libraries
+=================================
+
+To build own software against libraries distributed by OpenCSW, install the
+relevant ``*_dev`` packages. They contain the header files, and ``*.so``
+symlinks necessary during linking.
+
+When building againt OpenCSW software, these flags will typically make it
+work::
+
+  CPPFLAGS="-I/opt/csw/include"
+  LDFLAGS="-L/opt/csw/lib -R/opt/csw/lib"
+
+If you're building a 64-bit binary, use these::
+
+  CPPFLAGS="-I/opt/csw/include"
+  LDFLAGS="-L/opt/csw/lib/64 -R/opt/csw/lib/64"

Modified: csw/mgar/pkg/opencsw-policy/trunk/files/for-maintainers/filesystem-layout.rst
===================================================================
--- csw/mgar/pkg/opencsw-policy/trunk/files/for-maintainers/filesystem-layout.rst	2012-01-19 12:22:05 UTC (rev 16813)
+++ csw/mgar/pkg/opencsw-policy/trunk/files/for-maintainers/filesystem-layout.rst	2012-01-19 12:59:01 UTC (rev 16814)
@@ -15,3 +15,8 @@
 * /opt/csw (base of the hierarchy)
 * /etc/opt/csw (configuration files)
 * /var/opt/csw (data files)
+
+The /opt/csw directory and everything below is considered read-only. It's
+a common practice to set up non-global sparse zones with shared /opt/csw. In
+this setup, non-global zones see /opt/csw as mounted read-only. Any local
+state needs to be kept under /var/opt/csw.

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