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