usr/src/cmd/perl/contrib/Sun/Solaris/Project/README

   1 #
   2 # Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
   3 #
   4
   5 Licensing
   6 ---------
   7 This module is released under the Perl Artistic License.
   8
   9 Availability
  10 ------------
  11 This module is only available for Solaris 9 onwards.
  12
  13 Description
  14 -----------
  15 This module provided access to the Solaris Project subsystem, which is part of
  16 the Solaris resource management infrastructure.
  17
  18 For more information on Solaris Projects, see the project(4) manpage and the
  19 following on-line documentation:
  20
  21 System Administration Guide: Resource Management and Network Services
  22 Chapter 6 - Projects and Tasks
  23 http://docs.sun.com/db/doc/816-7125
  24
  25 An example of how this module might be used is to put the Apache httpd under
  26 resource management control, so that the total resources used by Apache can be
  27 limited using Solaris resource management.  Assuming mod_perl is installed for
  28 Apache, and a project with the appropriate limits has been established
  29 (see documentation references above), the following code in the Apache Perl
  30 startup file will place Apache under RM control:
  31
  32 use Sun::Solaris::Project qw(:ALL);
  33 my $user = getpwuid(Apache->server->uid());
  34 setproject(getdefaultproj($user), $user, 0) == 0 || die($!);
  35
  36 Installation
  37 ------------
  38
  39 1. Uncompress and untar the archive
  40 2. cd to the module directory
  41 3. perl Makefile.PL; make install
  42
  43 If you are using gcc and wish to build this module against the perl shipped as
  44 part of Solaris, see the Solaris-PerlGcc module, also available from CPAN.