NAME

syssgi - Perl interface to the IRIX syssgi system call

SYNOPSIS

  use SGI::syssgi;

  $sysid = SGI::syssgi::_SGI_SYSID();
  $process_name = SGI::syssgi::_SGI_RDNAME($process_id);
  $variable_value = SGI::syssgi::_SGI_GETNVRAM($variable_name);
  $success = SGI::syssgi::_SGI_SETNVRAM($variable_name, $new_value);
  $success = SGI::syssgi::_SGI_SETLED(1);
  $success = SGI::syssgi::_SGI_SSYNC();
  $success = SGI::syssgi::_SGI_BDFLUSHCNT($kernel_write_delay);
  $success = SGI::syssgi::_SGI_SET_AUTOPWRON($startup_time);
  $timetrim = SGI::syssgi::_SGI_GETTIMETRIM();
  $success = SGI::syssgi::_SGI_SETTIMETRIM($new_timetrim);

REQUIRES

Perl 5 Silicon Graphics IRIX 6.5.x

DESCRIPTION

Perl interface to the IRIX specific syssgi system call. This allows for easy access to IRIX system functions from Perl. For further documentation on this API , see man syssgi.

MAIN METHODS

_SGI_SYSID

Returns the unique system identifier as characters.

_SGI_SETLED ( led_state )

Turns on or off the led on the machine, this only works for some machines. Platforms reported to work so far is: Indigo2 and O2. A led_state of 1 turns the led on, 0 turns the led off.

_SGI_RDNAME ( process_id )

Returns the process name for the pid specified by process_id

_SGI_GETNVRAM ( variable_name )

Retrieves the value associated with the by variable_name specified prom environment variable.

_SGI_SETNVRAM ( variable_name, new_value )

Alters the value associated with the by variable_name specified prom environment variable to the by new_value specified value.

_SGI_SSYNC

Synchronously flush out all delayed write buffers.

_SGI_BDFLUSHCNT ( kern_write_delay )

Delays the kernel from writing for <kern_write_delay> seconds and returns the previous flush delay. The normal flush delay will be applied after this call. This is intended to be used in conjunction with _SGI_SSYNC on uniprocessor systems to keep the kernel from performing unwanted disk activity.

_SGI_SET_AUTOPWRON ( power_on )

Sets the time at when the system is to automatically power up again. This only works if the machine is powered off at this time. It is also only implemented on the following: platforms: Octane (2?), Indy, Indigo2 and Challenge M.

_SGI_GETTIMETRIM

Returns the current timetrim value. The system clock is adjusted every second by the signed number of nanoseconds specified by this parameter.

_SGI_SETTIMETRIM ( timetrim_value )

Change the timetrim value from the value originally configued in: /var/sysgen/mtune/kernel.

VARIABLES

NVRAM_INITSTATE

The initstate nvram environment variable. Stringvalue.

NVRAM_PATH

The path nvram environment variable. Stringvalue.

NVRAM_SHOWCONFIG

The path showconfig environment variable. Stringvalue.

NVRAM_SWAP

The swap nvram environment variable. Stringvalue.

NVRAM_VERBOSE

The verbose nvram environment variable. Stringvalue.

AUTHORS

Daniel Gustafson daniel@hobbit.se

SEE ALSO

IRIX manpages for syssgi and nvram.