Content-type: text/html Manpage of mcsysinfoperl

mcsysinfoperl

Section: C Library Functions (3)
Updated: 15 March 2002
Index Return to Main Contents
 

NAME

mcsysinfoperl - MagniComp(tm) SysInfo(tm) Perl API to obtain detailed system information in a platform neutral manner  

SYNOPSIS

use lib ('/opt/sysinfo/lib/mcSysInfo');
use mcSysInfo;

$mcSysInfo = mcSysInfo->New;

# Optional: Specify pathname to sysinfo(1)
$mcSysInfo->Program($SysInfoPath);
# Optional: Use $InFile in place of sysinfo(1)
$mcSysInfo->InputFile($InFile);
# Optional: Limit data to class List
$mcSysInfo->Class(@List);


$mcSysInfo->Retrieve();
 

DESCRIPTION

The mcSysInfo perl(1) interface is part of SysInfo(tm) from MagniComp(tm). It provides a perl(1) object (API) for obtaining detailed data about the local system's configuration via a platform neutral interface.

Please see mcsysinfoc(3) if a C API is required.

When mcSysInfo->Retrieve is called it runs the sysinfo(1) command by default to obtain the system configuration data. The data is parsed into perl(1) objects and made available as members of mcSysInfo (see below for details).  

OBJECT DEFINETIONS

 

OBJECT mcSysInfo

The following is a list of object members available for the mcSysInfo object:

Class(@List)
Limit the class of information retrieved and returned to @List. The contents of @List should be valid class names as returned by sysinfo -list class The default is to return all class types.
InputFile(Path)
Use the file specified by Path as input instead of running the sysinfo(1) program. The file must be the output from sysinfo -repsep '|' -format report The default is to run the sysinfo(1) program.
Program(Path)
Use Path as the pathname to the sysinfo(1) program. The default is /opt/sysinfo/bin/sysinfo

The following mcSysInfo object members contain the system configuration data after mcSysInfo->Retrieve is called:

General
General system configuration data. See OBJECT mcGeneral below.
Hardware
Hardware (device) configuration data. See OBJECT mcHardware below.
Software
Installed software data. See OBJECT mcSoftware below.
Partition
Disk partition data. See OBJECT mcPartition below.
Printer
Printer queue data. See OBJECT mcPrinter below.
SysConf
System configuration data. See OBJECT mcSysConf below.
Kernel
Kernel configuration data. See OBJECT mcKernel below.

 

OBJECT mcHardware

The mcHardware object contains data on what hardware (devices) is installed on the system. The following are valid members:
Entries
Returns a hash of mcDevInfo objects each of which details an installed device. The hash key is a unique device name. The value is an mcDevInfo object. See OBJECT mcDevInfo for details.

A special device entry with a key of TOTAL DISK contains the total amount of disk space on the system.  

OBJECT mcDevInfo

The table below specifies the valid members of the mcDevInfo object and describes their usage. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
AliasesAliasesArray
AltNameAKA NameScalar
BusBus no. of deviceScalar
CapacityCapacity (size) of deviceScalar
ClassTypeClass TypeScalar
DescListList of misc descriptionsArray
DevNumDevice no. on BusScalar
DevSpecDevice type specific datavaries
DriverDriver nameScalar
FilesFilesArray
IdentIdentifierScalar
ModelModelScalar
ModelDescModel DescriptionScalar
NameName of deviceScalar
NextNext peer deviceScalar
NodeIDNode IDScalar
PartPart #Scalar
PortPort no. on BusScalar
RevisionRevisionScalar
SerialSerial #Scalar
SlavesList of child devicesArray
SpeedSpeed of deviceScalar
TypeTypeScalar
UnitUnitScalar
VendorManufacturerScalar
 

OBJECT mcCpuInfo

The table below specifies the valid members of the mcCpuInfo object and describes their usage. A mcCpuInfo object is usually available via mcDevInfo->DevSpec when mcDevInfo->Type is CPU. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
ArchArchitectureScalar
ArchVerArchitecture VersionScalar
BitSizeBit SizeScalar
CachesList of onboard cachesArray
HasFPUHas FPUScalar
ManManufacturerScalar
ModelModelScalar
SerialSerial #Scalar
SpeedClock SpeedScalar
SteppingSteppingScalar

 

OBJECT mcCacheInfo

The table below specifies the valid members of the mcCacheInfo object and describes their usage. A mcCacheInfo object is usually available via the mcDevInfo->DevSpec->Caches array when mcDevInfo->Type is processor. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
NameName of the cacheScalar
DeviceName of device cache is onScalar
EnabledIs the cache enabled?Scalar
TypeThe type of cacheScalar
SizeThe size of the cache (KB)Scalar
SpeedClock SpeedScalar
AssocAssociativetyScalar
Lines# of LinesScalar
LineSizeLine SizeScalar
TLB# TLBScalar
TLBAssocTLB AssociativetyScalar
SocketedIs cache socketed?Scalar
LocationLocation relative to CPUScalar
SramTypeType of SRAMScalar
EccTypeECC TypeScalar
ModeMode of operationScalar

 

OBJECT mcGeneral

The mcGeneral object contains general system configuration data. The table below specifies the valid members of the mcGeneral object and describes their usage. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
HostnameHost NameScalar
HostAliasesHost AliasesArray
HostAddrsHost AddressesArray
HostIdHost IDScalar
SerialSerial #Scalar
ManShortManufacturer (Short)Scalar
ManLongManufacturer (Long)Scalar
ManManufacturerScalar
ModelModelScalar
PhysMemPhysical MemoryScalar
VirtMemVirtual MemoryScalar
RomVerROM VersionScalar
NumCpuNumber of CPUScalar
CpuTypeCPU TypeScalar
CpuSpeedCPU SpeedScalar
AppArchApp ArchitectureScalar
KernArchKernel ArchitectureScalar
KernBitsKernel Bit SizeScalar
OSnameOS NameScalar
OSverOS VersionScalar
OSdistOS DistributionScalar
KernVerKernel VersionScalar
BootTimeBoot TimeScalar
CurrentTimeCurrent TimeScalar
LibcNameLibc NameScalar
LibcVerLibc VersionScalar

 

OBJECT mcKernel

The mcKernel object contains data on kernel variables and configuration. The following are valid members:
Entries
Returns a hash of mcName objects each of which details a kernel entry. The hash key is a unique variable name. The value is an mcName object. See OBJECT mcName for details.

 

OBJECT mcNetIf

The table below specifies the valid members of the mcNetIf object and describes their usage. A mcNetIf object is usually available via mcDevInfo->DevSpec when mcDevInfo->Type is netif. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
TypeNIC Address TypeScalar
HostAddrNIC Host AddressScalar
HostNameNIC Host NameScalar
MACaddrNIC MAC Current AddressScalar
MACnameNIC MAC Current NameScalar
FacMACaddrNIC MAC Factory AddressScalar
FacMACnameNIC MAC Factory NameScalar
NetAddrNIC Network AddressScalar
NetNameNIC Network NameScalar

 

OBJECT mcPartition

The mcPartition object contains data on what disk partitions are on the system. The following are valid members:
Entries
Returns a hash of mcPartInfo objects each of which details a partition entry. The hash key is a unique partition name. The value is an mcPartInfo object. See OBJECT mcPartInfo for details.
 

OBJECT mcPartInfo

The table below specifies the valid members of the mcPartInfo object and describes their usage. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
NamePartition NameScalar
DevNameDevice NameScalar
DevPathDevice PathScalar
DevPathRawDevice Path RawScalar
BaseNameBase NameScalar
SliceSliceScalar
NumPartition #Scalar
TypeTypeScalar
TypeDescType DescriptionScalar
TypeNumType NumberScalar
UsageStatusUsage StatusScalar
MntNameMount NameScalar
MntOptsMount OptionsArray
SizeSize (MB)Scalar
AmtUsedAmount Used (MB)Scalar
SecSizeSector Size (bytes)Scalar
StartSectStarting SectorScalar
EndSectEnding SectorScalar
NumSectNumber of SectorsScalar
 

OBJECT mcPrinter

The mcPrinter object contains data on what printer queues are on the system. The following are valid members:
Entries
Returns a hash of mcPrinterInfo objects each of which details a printer queue. The hash key is a unique printer name. The value is an mcPrinterInfo object. See OBJECT mcPrinterInfo for details.
 

OBJECT mcPrinterInfo

The table below specifies the valid members of the mcPrinterInfo object and describes their usage. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
NameQueue NameScalar
AliasesQueue AliasesArray
DescriptDescription of queueScalar
VendorPrinter VendorScalar
ModelPrinter ModelScalar
ProtoCommunication ProtocolScalar
DevicePathname to printer deviceScalar
ServerName of server printer is onScalar
RemoteQueueQueue name on ServerScalar
LangsSupported printer languagesArray
SpoolDirSpool DirectoryScalar
MaxJobSizeMax size of each jobScalar
DescListMisc descriptionsArray

 

OBJECT mcSoftware

The mcSoftware object contains data on what software is installed on the system. The following are valid members:
Entries
Returns a hash of mcSoftInfo objects each of which details an installed software package. The hash key is a unique package name. The value is an mcSoftInfo object. See OBJECT mcSoftInfo for details.
 

OBJECT mcSoftInfo

The table below specifies the valid members of the mcSoftInfo object and describes their usage. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
NameName of packageScalar
EntryTypeEntry TypeScalar
VersionVersionScalar
RevisionRevisionScalar
DescriptionDescriptionScalar
DescVerboseDescription (Verbose)Scalar
URLURLScalar
LicenseLicenseScalar
CopyrightCopyrightScalar
CategoryCategoryScalar
SubCategorySub-CategoryScalar
OSnameRequires OS NameScalar
OSversionRequires OS VersionScalar
ArchRequires ArchitectureScalar
ISArchRequires Inst Set ArchScalar
InstDateInstallation DateScalar
BuildDateBuild DateScalar
ProdStampProduction StampScalar
BaseDirBase DirectoryScalar
DiskUsageDisk UsageScalar
FileListFile ListArray
VendorNameVendor NameScalar
VendorEmailVendor EmailScalar
VendorPhoneVendor Phone #Scalar
VendorStockVendor Stock #Scalar
DescListList of misc description dataArray
MasterName of master packageScalar
MasterVerVersion of masterScalar
MasterRevRevisionof masterScalar
SlavesList of child packagesArray
NextNext peer packageScalar

 

OBJECT mcSysConf

The mcSysConf object contains data on system configuration data obtained via sysconf(3). The following are valid members:
Entries
Returns a hash of mcName objects each of which details a SysConf entry. The hash key is a unique SysConf variable name. The value is an mcName object. See OBJECT mcName for details.
 

OBJECT mcName

The table below specifies the valid members of the mcName object and describes their usage. See mcsysinfo(3) for more details describing each member.

MemberDescriptionReturns
NameVariable nameScalar
DescDescription o



 

Index

NAME
SYNOPSIS
DESCRIPTION
OBJECT DEFINETIONS
OBJECT mcSysInfo
OBJECT mcHardware
OBJECT mcDevInfo
OBJECT mcCpuInfo
OBJECT mcCacheInfo
OBJECT mcGeneral
OBJECT mcKernel
OBJECT mcNetIf
OBJECT mcPartition
OBJECT mcPartInfo
OBJECT mcPrinter
OBJECT mcPrinterInfo
OBJECT mcSoftware
OBJECT mcSoftInfo
OBJECT mcSysConf
OBJECT mcName

This document was created by man2html, using the manual pages.
Time: 16:34:05 GMT, April 25, 2002