README
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
README.ON
1#
2# Copyright (c) 2000, 2008, Oracle and/or its affiliates. All rights reserved.
3#
4
5This module is released as Public Source via the Comprehensive Perl Archive
6Network (http://www.cpan.org). If it is updated for any reason, a new
7release should be pushed to CPAN.
8
9The version number of this module is derived from the $VERSION variable in
10Project.pm. If anything under this directory is modified, $VERSION should be
11changed in Project.pm to update the module version number correctly. If this
12is not done, it will not be possible to upload the generated archive to CPAN,
13as CPAN requires that uploaded archives have unique names.
14
15To prepare the contents of the directory for release, they should be packaged
16up as a .tar.gz archive. The procedure for this is:
17
18$ /usr/perl5/bin/perl Makefile.PL
19$ make tardist
20
21This will produce the file for upload to CPAN. Contact cpan-support@sun.com
22for details of how to do this.
23