The solregis command initiates the Solaris user registration procedure. This allows users to register with Sun Microsystems and receive information about Solaris. Normally, solregis is executed in conditional mode as a part of desktop login so that users are prompted at desktop start up time to register, unless they have already done so.

The following options are supported:

-d

Delay display of the initial screen until a window manager has asserted control of the X display.

-c

Conditional mode. If specified, solregis will exit without any dialog displayed if: (1) $HOME/.solregis/disable exists, (2) DISABLE=1 is specified in /etc/default/solregis, or (3) the user has already registered.

The following resources can control the behavior and appearance of solregis:

disable

If TRUE, when executed in conditional mode solregis simply exits without displaying anything.

localeChoices

Specifies the number of localeChoicen, actionn and initialURLn sets. The first set is 0, so if localeChoices is 1, localeChoice0, action0,and initialURL0 are the only active resources. If localeChoices is 1, none of the localeChoicen strings are displayed, and action0, and so forth. are used. If localeChoices is greater than 1, each localeChoicen string is made an element in an exclusive choice list and the index of the selected item controls which actionn and initialURLn resources are applied.

localeChoicen

Specifies the string presented to the user for this choice.

actionn

Specifies the file name of the command to be executed (normally expected to be a World Wide Web browser) when the user selects "Register Now", or the special string "print". If "print" is specified, the initialURLn string must be a file name on the local system, naming a file which is to be printed after prompting the user for a print destination.

initialURLn

Specifies the argument to be passed to actionn for initial registration. This will normally be the Universal Resource Locator for the initial page to be displayed by the World Wide Web browser.

printContext

XFN naming context under which the printers to display to the user if the special "print" action are named, in the service/printer context. For example, if the default printContext "thisorgunit" is used, the printers in thisorgunit/service/printer are displayed.

See environ(5) for descriptions of the following environment variables that affect the execution of solregis: HOME, LANG, LC_MESSAGES, and NLSPATH.

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

/etc/default/solregis

Default values.

/$HOME/.solregis/uprops

User registration information.

/$HOME/.solregis/disable

Users disabled from registration.

/usr/dt/app-defaults/C/Solregis

Default locale resources.

/usr/dt/app-defaults/$LANG/Solregis

Default localized resources.

/etc/dt/app-defaults/C/Solregis

Default installation resources.

/usr/dt/app-defaults/$LANG/Solregis

Localized installation resources.

See attributes(5) for descriptions of the following attributes:

attributes(5), environ(5)