Perl Interface to libexacct - Oracle Solaris 11.1 Administration: Oracle Solaris Zones, Oracle Solaris 10 Zones, and Resource Management

Perl Interface to `libexacct`

The Perl interface allows you to create Perl scripts that can read the accounting files produced by the exacct framework. You can also create Perl scripts that write exacct files.

The interface is functionally equivalent to the underlying C API. When possible, the data obtained from the underlying C API is presented as Perl data types. This interface allows easier access to the data, and removes the need for buffer pack and unpack operations. Moreover, all memory management is performed by the Perl library.

The various project, task, and exacct-related functions are separated into groups. Each group of functions is located in a separate Perl module. Each module begins with Oracle Solaris standard Sun::Solaris:: Perl package prefix. All of the classes provided by the Perl exacct library are found under the Sun::Solaris::Exacct module.

The underlying libexacct(3LIB) library provides operations on exacct format files, catalog tags, and exacct objects. exacct objects are subdivided into two types:

Items, which are single-data values (scalars)
Groups, which are lists of Items

The following table summarizes each of the modules.

Module (should not contain spaces)	Description	For More Information
`Sun::Solaris::Project`	This module provides functions to access the project manipulation functions `getprojid`(2), `endprojent`(3PROJECT) , `fgetprojent`(3PROJECT), `getdefaultproj`(3PROJECT), `getprojbyid`(3PROJECT), `getprojbyname`(3PROJECT), `getprojent`(3PROJECT), `getprojidbyname`(3PROJECT), `inproj`(3PROJECT), `project_walk`(3PROJECT), `setproject`(3PROJECT) , and `setprojent`(3PROJECT).	`Project`(3PERL)
`Sun::Solaris::Task`	This module provides functions to access the task manipulation functions `gettaskid`(2) and `settaskid`(2).	`Task`(3PERL)
`Sun::Solaris::Exacct`	This module is the top-level `exacct` module. This module provides functions to access the `exacct`-related system calls `getacct`(2), `putacct`(2), and `wracct`(2). This module also provides functions to access the `libexacct`(3LIB) library function `ea_error`(3EXACCT). Constants for all of the `exacct` EO_, EW_, EXR_, P_, and TASK_* macros are also provided in this module.	`Exacct`(3PERL)
`Sun::Solaris::Exacct:: Catalog`	This module provides object-oriented methods to access the bitfields in an `exacct` catalog tag. This module also provides access to the constants for the EXC_, EXD_, and EXD_* macros.	`Exacct::Catalog`(3PERL)
`Sun::Solaris::Exacct:: File`	This module provides object-oriented methods to access the `libexacct` accounting file functions `ea_open`(3EXACCT), `ea_close`(3EXACCT), `ea_get_creator`(3EXACCT), `ea_get_hostname`(3EXACCT), `ea_next_object`(3EXACCT), `ea_previous_object`(3EXACCT), and `ea_write_object`(3EXACCT).	`Exacct::File`(3PERL)
`Sun::Solaris::Exacct:: Object`	This module provides object-oriented methods to access an individual `exacct` accounting file object. An `exacct` object is represented as an opaque reference blessed into the appropriate `Sun::Solaris::Exacct::Object` subclass. This module is further subdivided into the object types Item and Group. At this level, there are methods to access the `ea_match_object_catalog`(3EXACCT) and `ea_attach_to_object`(3EXACCT) functions.	`Exacct::Object`(3PERL)
`Sun::Solaris::Exacct:: Object::Item`	This module provides object-oriented methods to access an individual `exacct` accounting file Item. Objects of this type inherit from `Sun::Solaris::Exacct::Object`.	`Exacct::Object::Item`(3PERL)
`Sun::Solaris::Exacct:: Object::Group`	This module provides object-oriented methods to access an individual `exacct` accounting file Group. Objects of this type inherit from `Sun::Solaris::Exacct::Object`. These objects provide access to the `ea_attach_to_group`(3EXACCT) function. The Items contained within the Group are presented as a Perl array.	`Exacct::Object::Group`(3PERL)
`Sun::Solaris::Kstat`	This module provides a Perl tied hash interface to the `kstat` facility. A usage example for this module can be found in `/bin/kstat`, which is written in Perl.	`Kstat`(3PERL)

For examples that show how to use the modules described in the previous table, see Using the Perl Interface to libexacct.

Skip Navigation Links
Exit Print View
	Oracle Solaris 11.1 Administration: Oracle Solaris Zones, Oracle Solaris 10 Zones, and Resource Management Oracle Solaris 11.1 Information Library