17c478bd9Sstevel@tonic-gate#
2c227543fSJohn Sonnenschein# Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
37c478bd9Sstevel@tonic-gate#
47c478bd9Sstevel@tonic-gate
57c478bd9Sstevel@tonic-gateLicensing
67c478bd9Sstevel@tonic-gate---------
77c478bd9Sstevel@tonic-gateThis module is released under the Perl Artistic License.
87c478bd9Sstevel@tonic-gate
97c478bd9Sstevel@tonic-gateAvailability
107c478bd9Sstevel@tonic-gate------------
117c478bd9Sstevel@tonic-gateThis module is only available for Solaris 9 onwards.
127c478bd9Sstevel@tonic-gate
137c478bd9Sstevel@tonic-gateDescription
147c478bd9Sstevel@tonic-gate-----------
157c478bd9Sstevel@tonic-gateThis module provided access to the Solaris Project subsystem, which is part of
167c478bd9Sstevel@tonic-gatethe Solaris resource management infrastructure.
177c478bd9Sstevel@tonic-gate
18*bbf21555SRichard LoweFor more information on Solaris Projects, see the project(5) manpage and the
197c478bd9Sstevel@tonic-gatefollowing on-line documentation:
207c478bd9Sstevel@tonic-gate
217c478bd9Sstevel@tonic-gateSystem Administration Guide: Resource Management and Network Services
227c478bd9Sstevel@tonic-gateChapter 6 - Projects and Tasks
237c478bd9Sstevel@tonic-gatehttp://docs.sun.com/db/doc/816-7125
247c478bd9Sstevel@tonic-gate
257c478bd9Sstevel@tonic-gateAn example of how this module might be used is to put the Apache httpd under
267c478bd9Sstevel@tonic-gateresource management control, so that the total resources used by Apache can be
277c478bd9Sstevel@tonic-gatelimited using Solaris resource management.  Assuming mod_perl is installed for
287c478bd9Sstevel@tonic-gateApache, and a project with the appropriate limits has been established
297c478bd9Sstevel@tonic-gate(see documentation references above), the following code in the Apache Perl
307c478bd9Sstevel@tonic-gatestartup file will place Apache under RM control:
317c478bd9Sstevel@tonic-gate
327c478bd9Sstevel@tonic-gateuse Sun::Solaris::Project qw(:ALL);
337c478bd9Sstevel@tonic-gatemy $user = getpwuid(Apache->server->uid());
347c478bd9Sstevel@tonic-gatesetproject(getdefaultproj($user), $user, 0) == 0 || die($!);
357c478bd9Sstevel@tonic-gate
367c478bd9Sstevel@tonic-gateInstallation
377c478bd9Sstevel@tonic-gate------------
387c478bd9Sstevel@tonic-gate
397c478bd9Sstevel@tonic-gate1. Uncompress and untar the archive
407c478bd9Sstevel@tonic-gate2. cd to the module directory
417c478bd9Sstevel@tonic-gate3. perl Makefile.PL; make install
427c478bd9Sstevel@tonic-gate
437c478bd9Sstevel@tonic-gateIf you are using gcc and wish to build this module against the perl shipped as
447c478bd9Sstevel@tonic-gatepart of Solaris, see the Solaris-PerlGcc module, also available from CPAN.
45