solregis(1)

NAME

solregis − Solaris user registration

SYNOPSIS

/usr/dt/bin/solregis [ −dc ]

DESCRIPTION

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.

OPTIONS

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.

EXIT CODES

The following exit codes are returned:

0 Successful completion.

>0 An error occurred.

USAGE

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

Name	Class	Value Type	Default
disable	Disable	Boolean	False
localeChoices	LocaleChoices	Int	1
action0	Action	String	/usr/dt/bin/hotjava
initialURL0	URL	String	file:///usr/dt/app-config \
			/solregis/EReg.html
localeChoice<n>	LocaleChoice	String	null
action<n>	Action	String	null for n>0
initialURL<n>	URL	String	null for n>0
printContext	PrintContext	String	thisorgunit

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.

ENVIRONMENT

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

FILES

/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.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWsregu

Museum

Related Articles