xref: /onnv-gate/usr/src/cmd/perl/contrib/Sun/Solaris/Exacct/README (revision 12388:1bc8d55b0dfd)
10Sstevel@tonic-gate#
2*12388SJohn.Sonnenschein@Sun.COM# Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved.
30Sstevel@tonic-gate#
40Sstevel@tonic-gate
50Sstevel@tonic-gateLicensing
60Sstevel@tonic-gate---------
70Sstevel@tonic-gateThis module is released under the Perl Artistic License.
80Sstevel@tonic-gate
90Sstevel@tonic-gateAvailability
100Sstevel@tonic-gate------------
110Sstevel@tonic-gateThis module is only available for Solaris 9 onwards.
120Sstevel@tonic-gate
130Sstevel@tonic-gateDescription
140Sstevel@tonic-gate-----------
150Sstevel@tonic-gateThis module provided access to the Solaris Extended Accounting (exacct)
160Sstevel@tonic-gatesubsystem, which is part of the Solaris resource management infrastructure.
170Sstevel@tonic-gate
180Sstevel@tonic-gateFor more information on Solaris Extended Accounting, see the libexacct(3LIB)
190Sstevel@tonic-gateand acctadm(1M) manpages and the following on-line documentation:
200Sstevel@tonic-gate
210Sstevel@tonic-gateSystem Administration Guide: Resource Management and Network Services
220Sstevel@tonic-gateChapter 7 - Extended Accounting
230Sstevel@tonic-gatehttp://docs.sun.com/db/doc/816-7125, or any later version
240Sstevel@tonic-gate
250Sstevel@tonic-gateAn example of how this module might be used is to dump the contents of an
260Sstevel@tonic-gateexacct data file:
270Sstevel@tonic-gate
280Sstevel@tonic-gateuse Sun::Solaris::Exacct qw(:EXACCT_ALL);
290Sstevel@tonic-gatedie("Usage is dumpexacct <exacct file>\n") unless (@ARGV == 1);
300Sstevel@tonic-gatemy $ef = ea_new_file($ARGV[0], &O_RDONLY) || die(ea_error_str());
310Sstevel@tonic-gateprintf("Creator:  %s\n", $ef->creator());
320Sstevel@tonic-gateprintf("Hostname: %s\n\n", $ef->hostname());
330Sstevel@tonic-gatewhile (my $obj = $ef->get()) {
340Sstevel@tonic-gate        ea_dump_object($obj);
350Sstevel@tonic-gate}
360Sstevel@tonic-gateif (ea_error() != EXR_OK && ea_error() != EXR_EOF)  {
370Sstevel@tonic-gate        printf("\nERROR: %s\n", ea_error_str());
380Sstevel@tonic-gate        exit(1);
390Sstevel@tonic-gate}
400Sstevel@tonic-gateexit(0);
410Sstevel@tonic-gate
420Sstevel@tonic-gateInstallation
430Sstevel@tonic-gate------------
440Sstevel@tonic-gate
450Sstevel@tonic-gate1. Uncompress and untar the archive
460Sstevel@tonic-gate2. cd to the module directory
470Sstevel@tonic-gate3. perl Makefile.PL; make install
480Sstevel@tonic-gate
490Sstevel@tonic-gateIf you are using gcc and wish to build this module against the perl shipped as
500Sstevel@tonic-gatepart of Solaris, see the Solaris-PerlGcc module, also available from CPAN.
51