Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ././../../../../../../usr/man/man3perl/Exacct::File.3perl
Real path: /usr/perl5/5.36/man/man3/Sun::Solaris::Exacct::File.3
Zurück

.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "..::pod::File 3" .TH ..::pod::File 3 "2023-05-15" "perl v5.36.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Sun::Solaris::Exacct::File \- exacct file manipulation .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 3 \& use Sun::Solaris::Exacct::File qw(:ALL); \& my $ea_file = Sun::Solaris::Exacct::File\->new($myfile, &O_RDONLY); \& my $ea_obj = $ea_file\->get(); .Ve .PP This module provides access to the \f(CW\*(C`libexacct(3LIB)\*(C'\fR functions that manipulate accounting files. The interface is object-oriented and allows the creation and reading of libexacct files. The C library calls wrapped by this module are \f(CW\*(C`ea_open(3EAXACCT)\*(C'\fR, \f(CW\*(C`ea_close(3EAXACCT)\*(C'\fR, \&\f(CW\*(C`ea_next_object(3EAXACCT)\*(C'\fR, \f(CW\*(C`ea_previous_object(3EAXACCT)\*(C'\fR, \&\f(CW\*(C`ea_write_object(3EAXACCT)\*(C'\fR, \f(CW\*(C`ea_get_object(3EAXACCT)\*(C'\fR, \&\f(CW\*(C`ea_get_creator(3EAXACCT)\*(C'\fR, and \f(CW\*(C`ea_get_hostname(3EAXACCT)\*(C'\fR. The file read and write methods all operate on \f(CW\*(C`Sun::Solaris::Exacct::Object\*(C'\fR objects and perform all the necessary memory management, packing, unpacking, and structure conversions that are required. .SS "Constants" .IX Subsection "Constants" \&\f(CW\*(C`EO_HEAD\*(C'\fR, \f(CW\*(C`EO_TAIL\*(C'\fR, \f(CW\*(C`EO_NO_VALID_HDR\*(C'\fR, \f(CW\*(C`EO_POSN_MSK\*(C'\fR, and \&\f(CW\*(C`EO_VALIDATE_MSK\*(C'\fR. Other constants needed by the \f(CW\*(C`new()\*(C'\fR method below are in the standard Perl \f(CW\*(C`Fcntl\*(C'\fR module. .SS "Functions" .IX Subsection "Functions" None. .SS "Class methods" .IX Subsection "Class methods" \&\fB\f(CB\*(C`new($name, $oflags, creator => $creator, aflags => $aflags, mode => $mode)\*(C'\fB\fR .PP This method opens a libexacct file as specified by the mandatory parameters \&\f(CW$name\fR and \f(CW$oflags\fR, and returns a \f(CW\*(C`Sun::Solaris::Exacct::File\*(C'\fR object, or \f(CW\*(C`undef\*(C'\fR if an error occurs. The parameters \f(CW$creator\fR, \f(CW$aflags\fR, and \&\f(CW$mode\fR are optional and are passed as \f(CW\*(C`(name =\*(C'\fR value)> pairs. The only valid values for \f(CW$oflags\fR are the combinations of \f(CW\*(C`O_RDONLY\*(C'\fR, \f(CW\*(C`O_WRONLY\*(C'\fR, \&\f(CW\*(C`O_RDWR\*(C'\fR, and \f(CW\*(C`O_CREAT\*(C'\fR described below. .PP The \f(CW$creator\fR parameter is a string describing the creator of the file. If it is required (for instance, when writing to a file) but absent, it is set to the string representation of the caller's \s-1UID.\s0 The \f(CW$aflags\fR parameter describes the required positioning in the file for \f(CW\*(C`O_RDONLY\*(C'\fR access: either \&\f(CW\*(C`EO_HEAD\*(C'\fR or \f(CW\*(C`EO_TAIL\*(C'\fR are allowed. If absent, \f(CW\*(C`EO_HEAD\*(C'\fR is assumed. The \&\f(CW$mode\fR parameter is the file creation mode and is ignored unless \f(CW\*(C`O_CREAT\*(C'\fR is specified in \f(CW$oflags\fR. If \f(CW$mode\fR is unspecified, the file creation mode is set to \f(CW0666\fR (octal). If an error occurs, it can be retrieved with the \&\f(CW\*(C`Sun::Solaris::Exacct::ea_error()\*(C'\fR function. (See \f(CWSun::Solaris::Exacct(3)\fR). .PP \&\fB\f(CB\*(C` $oflags $aflags Action\*(C'\fB\fR .PP .Vb 3 \& O_RDONLY Absent or EO_HEAD Open for reading \& at the start of \& the file. \& \& O_RDONLY EO_TAIL Open for reading \& at the end of the \& file. \& \& O_WRONLY Ignored File must exist, \& open for writing \& at the end of the \& file. \& \& O_WRONLY | O_CREAT Ignored Create file if it \& does not exist, \& otherwise truncate \& and open for writing. \& \& O_RDWR Ignored File must exist, \& open for \& reading/writing, \& positioned at the \& end of the file. \& \& O_RDWR | O_CREAT Ignored Create file if it \& does not exist, \& otherwise truncate \& and open for \& reading/writing. .Ve .SS "Object methods" .IX Subsection "Object methods" \&\fBNote:\fR Closing a \f(CW\*(C`Sun::Solaris::Exacct::File\*(C'\fR .PP There is no explicit \f(CW\*(C`close()\*(C'\fR method for a \f(CW\*(C`Sun::Solaris::Exacct::File\*(C'\fR. The file is closed when the file handle object is undefined or reassigned. .PP \&\fB\f(CB\*(C`creator()\*(C'\fB\fR .PP This method returns a string containing the creator of the file or \f(CW\*(C`undef\*(C'\fR if the file does not contain the information. .PP \&\fB\f(CB\*(C`hostname()\*(C'\fB\fR .PP This method returns a string containing the hostname on which the file was created, or \f(CW\*(C`undef\*(C'\fR if the file does not contain the information. .PP \&\fB\f(CB\*(C`next()\*(C'\fB\fR .PP This method reads the header information of the next record in the file. In a scalar context the value of the type field is returned as a dual-typed scalar that will be one of \f(CW\*(C`EO_ITEM\*(C'\fR, \f(CW\*(C`EO_GROUP\*(C'\fR, or \f(CW\*(C`EO_NONE\*(C'\fR. In a list context it returns a two-element list containing the values of the type and catalog fields. The type element is a dual-typed scalar. The catalog element is blessed into the \f(CW\*(C`Sun::Solaris::Exacct::Catalog\*(C'\fR class. If an error occurs, \&\f(CW\*(C`undef\*(C'\fR or \f(CW\*(C`(undef, undef)\*(C'\fR is returned depending upon context. The status can be accessed with the \f(CW\*(C`Sun::Solaris::Exacct::ea_error()\*(C'\fR function. (See \&\f(CWSun::Solaris::Exacct(3)\fR). .PP \&\fB\f(CB\*(C`previous()\*(C'\fB\fR .PP This method reads the header information of the previous record in the file. In a scalar context it returns the type field. In a list context it returns the two element list containing the values of the type and catalog fields, in the same manner as the \f(CW\*(C`next()\*(C'\fR method. Error are also returned in the same manner as the \f(CW\*(C`next()\*(C'\fR method. .PP \&\fB\f(CB\*(C`get()\*(C'\fB\fR .PP This method reads in the libexacct record at the current position in the file and returns a \f(CW\*(C`Sun::Solaris::Exacct::Object\*(C'\fR containing the unpacked data from the file. This object can then be further manipulated using its methods. In case of error \f(CW\*(C`undef\*(C'\fR is returned and the error status is made available with the \f(CW\*(C`Sun::Solaris::Exacct::ea_error()\*(C'\fR function. After this operation, the position in the file is set to the start of the next record in the file. .PP \&\fB\f(CB\*(C`write(@ea_obj)\*(C'\fB\fR .PP This method converts the passed list of \f(CW\*(C`Sun::Solaris::Exacct::Object\*(C'\fRs into libexacct file format and appends them to the libexacct file, which must be open for writing. This method returns \f(CW\*(C`true\*(C'\fR if successful and \f(CW\*(C`false\*(C'\fR otherwise. On failure the error can be examined with the \&\f(CW\*(C`Sun::Solaris::Exacct::ea_error()\*(C'\fR function. .SS "Exports" .IX Subsection "Exports" By default nothing is exported from this module. The following tags can be used to selectively import constants defined in this module: .PP .Vb 2 \& :CONSTANTS EO_HEAD, EO_TAIL, EO_NO_VALID_HDR, EO_POSN_MSK, and \& EO_VALIDATE_MSK \& \& :ALL :CONSTANTS, Fcntl(:DEFAULT). .Ve .SH "ATTRIBUTES" .IX Header "ATTRIBUTES" See \f(CWattributes(7)\fR for descriptions of the following attributes: .PP .Vb 7 \& _\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_ \& | ATTRIBUTE TYPE | ATTRIBUTE VALUE | \& |_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_| \& | Availability | SUNWpl5u | \& |_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_| \& | Interface Stability | CPAN (http://www.cpan.org) | \& |_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_\|_| .Ve .SH "SEE ALSO" .IX Header "SEE ALSO" \&\f(CW\*(C`ea_close(3EXACCT)\*(C'\fR, \f(CW\*(C`ea_get_creator(3EXACCT)\*(C'\fR, \f(CW\*(C`ea_get_hostname(3EXACCT)\*(C'\fR, \&\f(CW\*(C`ea_get_object(3EXACCT)\*(C'\fR, \f(CW\*(C`ea_next_object(3EXACCT)\*(C'\fR, \f(CW\*(C`ea_open(3EXACCT)\*(C'\fR, \&\f(CW\*(C`ea_previous_object(3EXACCT)\*(C'\fR, \f(CW\*(C`ea_write_object(3EXACCT)\*(C'\fR, \&\f(CWSun::Solaris::Exacct(3)\fR, \f(CWSun::Solaris::Exacct::Catalog(3)\fR, \&\f(CWSun::Solaris::Exacct::Object(3)\fR, \f(CWSun::Solaris::Exacct::Object::Group(3)\fR, \&\f(CWSun::Solaris::Exacct::Object::Item(3)\fR, \f(CW\*(C`libexacct(3LIB)\*(C'\fR, \f(CWattributes(7)\fR