Hallo, dies ist ein Test.

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

Running in File Mode
Relative path: ././../../../../../../usr/man/man3perl/Pg.3perl
Real path: /usr/perl5/5.36/man/man3/Sun::Solaris::Pg.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::Pg 3" .TH pod::Pg 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" Solaris::Pg \- Perl interface to Processor Group kstats .SH "SYNOPSYS" .IX Header "SYNOPSYS" .Vb 1 \& use Solaris::Pg; \& \& $p = Solaris::Pg\->new(\-cpudata=> 1, \-tags=> 1, \-swload=> 1); \& \& @pgs = $p\->all(); \& \& @pgs_depth = $p\->all_depth_first(); \& \& @pgs_breadth = $p\->all_breadth_first(); \& \& @leaves = $p\->leaves(); \& \& $root = $p\->root; \& \& $p\->update(); \& \& $leaf = $leaves[0]; \& \& $name = $p\->sh_name($leaf); \& \& @names = $p\->sharing_relationships(); \& \& @tags = $p\->tags($leaf); \& \& $p1 = Solaris::Pg\->new(\-cpudata=> 1, \-tags=> 1, \-swload=> 1); \& \& if ($p\->has_utilization()) { \& $utilization = $p\->utilization($p1, $leaf); \& $capacity = $p\->capacity($p1, $leaf); \& $accuracy = $p\->accuracy($p1, $leaf); \& $tdelta = $p\->tdelta($p1); \& } \& \& $sw_utilization = $p\->sw_utilization($p1, $leaf);) .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" The Solaris::Pg module provides an interface to the Solaris \s-1PG\s0 information available through \fBpg\fR and \fBpg_cpu\fR kstats. The module provides an object oriented interface. .SH "METHODS" .IX Header "METHODS" .SS "new" .IX Subsection "new" Create a new Pg instance. The \fBnew()\fR function accepts arguments in the form of a hash. The following subarguments are supported: .IP "\-cpudata" 4 .IX Item "-cpudata" Collect per-CPU data from kstats if this is True. .IP "\-tags" 4 .IX Item "-tags" Match PGs to physical relationships if this is True. .IP "\-swload" 4 .IX Item "-swload" Collect software \s-1CPU\s0 load if this is True. .SS "root" .IX Subsection "root" Return \s-1ID\s0 of the root of Processor Group hierarchy. .SS "all" .IX Subsection "all" Return list of all PGs sorted by \s-1ID.\s0 .SS "\fBall_depth_first()\fP" .IX Subsection "all_depth_first()" Return list of all PGs sorted by walking the \s-1PG\s0 hierarchy depth first, starting from root. .SS "\fBall_breadth_first()\fP" .IX Subsection "all_breadth_first()" Return list of all PGs sorted by walking the \s-1PG\s0 hierarchy breadth first, starting from root. .SS "cpus(\s-1PG\s0)" .IX Subsection "cpus(PG)" Return list of all CPUs in the \s-1PG\s0 specified. The list is sorted by \s-1CPU ID.\s0 .SS "generation([\s-1PG\s0])" .IX Subsection "generation([PG])" Return the generation number for the given \s-1PG.\s0 Without arguments, return the generation number for the whole snapshot. Different generation number means that \&\s-1PG\s0 configuration may have changed. .SS "parent(\s-1PG\s0)" .IX Subsection "parent(PG)" Return parent \s-1ID\s0 or undef if there is no parent. .SS "children(\s-1PG\s0)" .IX Subsection "children(PG)" Return list of children for the \s-1PG.\s0 .SS "is_leaf(\s-1PG\s0)" .IX Subsection "is_leaf(PG)" Returns T iff \s-1PG\s0 is leaf. .SS "leaves" .IX Subsection "leaves" Returns list of leaf PGs. .SS "level(\s-1PG\s0)" .IX Subsection "level(PG)" Return the numeric level of \s-1PG\s0 in the hierarchy, starting from root which has level zero. .SS "sh_name(\s-1PG\s0)" .IX Subsection "sh_name(PG)" Returns sharing name for the \s-1PG.\s0 .SS "sharing_relationships([\s-1PG\s0], ...)" .IX Subsection "sharing_relationships([PG], ...)" Without any arguments, returns the list of sharing relationships in the snapshot. Relationships are sorted by the level in the hierarchy If any PGs are given on the command line, only return sharing relationships for given PGs, but still keep them sorted. .SS "tags(\s-1PG\s0)" .IX Subsection "tags(PG)" Return list of strings describing physical relationships ('core', 'chip') for the given \s-1PG.\s0 .SS "\fBupdate()\fP" .IX Subsection "update()" Update utilization and generation data in the \s-1PG\s0 snapshot. .SS "has_utilization(\s-1PG\s0)" .IX Subsection "has_utilization(PG)" Returns True if given \s-1PG\s0 hasd data about hardware utilization. .SS "utilization(\s-1PGOBJ, PG\s0)" .IX Subsection "utilization(PGOBJ, PG)" Return numeric utilization for the time interval represented by two \s-1PG\s0 objects for the given \s-1PG.\s0 Utilization is a difference in utilization value between two snapshots. The given \s-1PG\s0 must belong to the same generation in both snapshots. Returns \fBundef\fR if utilization can not be obtained. .SS "sw_utilization(\s-1PGOBJ, PG\s0)" .IX Subsection "sw_utilization(PGOBJ, PG)" Return numeric software utilization for the time interval represented by two \s-1PG\s0 objects for the given \s-1PG.\s0 Utilization is a difference in utilization value between two snapshots. The given \s-1PG\s0 must belong to the same generation in both snapshots. Returns \fBundef\fR if utilization can not be obtained. Software utilization is combined \s-1CPU\s0 load for all CPUs in the \s-1PG.\s0 Returns \fBundef\fR if utilization can not be obtained. .SS "sw_utilization(\s-1PGOBJ, PG, CPU\s0)" .IX Subsection "sw_utilization(PGOBJ, PG, CPU)" Return utilization for the \s-1PG\s0 for a given \s-1CPU\s0 in a given \s-1PG.\s0 Utilization is a difference in utilization value between two snapshots. We can only compare utilization between PGs having the same generation \s-1ID.\s0 Returns \fBundef\fR if utilization can not be obtained. .SS "capacity(\s-1PGOBJ, PG\s0)" .IX Subsection "capacity(PGOBJ, PG)" Return numeric capacity for the time interval represented by two \s-1PG\s0 objects for the given \s-1PG.\s0 Note that the actual capacity is the maximum of all capacities across all PGs of this type.The given \s-1PG\s0 must belong to the same generation in both snapshots. Returns \fBundef\fR if capacities can not be obtained. .SS "accuracy(\s-1PGOBJ, PG\s0)" .IX Subsection "accuracy(PGOBJ, PG)" Return accuracy of utilization calculation between two snapshots The accuracy is determined based on the total time spent running and not running the counters. If T1 is the time counters were running during the period and T2 is the time they were turned off, the accuracy is T1 / (T1 + T2), expressed in percentages. .SS "tdelta(\s-1PGOBJ, PG\s0)" .IX Subsection "tdelta(PGOBJ, PG)" Return time interval between two snapshots for the given \s-1PG.\s0 The time is expressed in seconds and is a floating-point number. .SS "\s-1EXPORT\s0" .IX Subsection "EXPORT" None by default. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBpginfo\fR\|(1), \fBpgstat\fR\|(1)