DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

chsysinfo(ADM)


chsysinfo -- change system name and version for applications

Syntax

/usr/sbin/chsysinfo [ osr5 | osr6 | uw7 | ou8 | default ]

Description

The chsysinfo command provides the ability to change the system name and/or version strings kept in system data structures. This is usually necessary only when installing or running applications that were designed to run on predecessor operating systems. You must be logged in as root to use this command.

Note that there are two methods for changing the system name for applications:


SCOMPAT
The SCOMPAT environment variable can be used to set system name and version returned by the uname command. The change applies only to the current process and its child processes, and is sufficient for any legacy application that only uses the command level interface to query the system name and version. See the uname(C) manual page.

The chsysinfo command changes the values returned by the uname command, and the system name and version returned by confstr(S), sysinfo(S), and uname(S). This more pervasive change is required only if the application being installed or run uses the above system calls to query the system name and version.

The changes made by chsysinfo are effective system wide; however, they do not persist across a reboot of the system. Upon reboot, the system will always have the default system name and version values specified in the file /etc/conf/pack.d/name/space.c.

Options

The following options are supported and change the system name and version as indicated to support applications designed to run on the corresponding systems:

option system name version
osr5 SCO_SV 5.0.7
osr6 SCO_SV 6.0.0
uw7 UnixWare 7.1.4
ou8 OpenUNIX 8.0.2
default SCO_SV 6.0.0

 +--------+-------------+---------+
 |option  | system name | version |
 +--------+-------------+---------+
 |osr5    | SCO_SV      | 5.0.7   |
 +--------+-------------+---------+
 |osr6    | SCO_SV      | 6.0.0   |
 +--------+-------------+---------+
 |uw7     | UnixWare    | 7.1.4   |
 +--------+-------------+---------+
 |ou8     | OpenUNIX    | 8.0.2   |
 +--------+-------------+---------+
 |default | SCO_SV      | 6.0.0   |
 +--------+-------------+---------+

Usage

The intent of chsysinfo is to enable the execution of applications that make installation or runtime checks for a particular system name or version via either command line utilities or system calls.

The installation of an application might fail with an error indicating that the installer detected an unsupported operating system version. The chsysinfo command can be used to allow the application to install. For example, if the installer requires a system version of "5.0.7", you could do the following:

   chsysinfo osr5
   custom [options]
   chsysinfo default

The first chsysinfo command changes the system name and version to "SCO_SV" and "5.0.7". After the package is installed with custom, the second chsysinfo command returns these values to their default values.

Similarly, applications that require runtime checks of the system name and version can be started with a "wrapper" script that executes chsysinfo prior to launching the application, as in this example:

   chsysinfo osr5
   /usr/bin/myapplication
   chsysinfo default

Files


/etc/conf/pack.d/name/space.c
file containing the values for system name and version used at boot time

References

confstr(S), sysinfo(S), uname(C), uname(S)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005