Secure Global Desktop Administration Guide > Users and authentication > Login script Tcl commands

Login script Tcl commands

As well as using Expect, the login scripts supplied with Secure Global Desktop make use of several Tcl commands. For example, the tarantella command connects to the application server instead of Expect and provides greater control over the connection. In addition, other Tcl commands are used, described here.

You can use these Tcl commands in your own login scripts.

authrequest

Syntax

authrequest [ -normal | -changed ]

Description

Displays a dialog box that indicates a problem with the username or password.

Argument	Description
`-normal`	Specifies that the password is incorrect.
`-changed`	Specifies that the password has expired.

Example

authrequest -normal

setbuffer

Syntax

setbuffer [ -buffer num ] [ -output 0|1 ]

Description

Defines the number of bytes to read from the application server.

Argument	Description
`-buffer num`	Specifies the number of bytes. Default is 1.
`-output 0\|1`	Turns output on (1) or off (0). Default is 1.

Example

setbuffer -buffer 1000

clienttimer

Syntax

clienttimer [ time ] [ message ] [ timers ]

Description

Displays message in the progress dialog box for the specified time. The progress bar has timers sections in total.

Example

clienttimer 10 "Launching the application" 4

canceltimer

Syntax

canceltimer

Description

Cancels the clienttimer command. Takes no arguments.

progress

Syntax

progress [ message ]

Description

Displays message in the progress dialog box.

Example

progress "Initializing..."

locallaunch

Syntax

locallaunch [ -start ] [ -abort ] [ -user launchspec -root launchspec ]

Description

Optimizes launch in the situation where the application server is also the Secure Global Desktop server.

Argument Description

-start Starts an optimized launch.

-abort Aborts the optimized launch and reverts to the standard connection method.

-user launchspec

Defines the connection methods to use for launching applications on the Secure Global Desktop server when the user is not root. You can specify different behavior for applications that are detached on launch (background applications) and those that aren't (foreground applications).

`launchspec`	Description
0	Launches all applications using the Connection Method defined for the application object.
1	Background applications use /bin/su. Foreground applications use the application object's Connection Method.
2	Background applications use the application object's Connection Method. Foreground applications use /bin/su.
3	Launches all applications using /bin/su.

-root launchspec

Defines the connection methods to use for launching applications on the Secure Global Desktop server when the user is root. You can specify different behavior for applications that are detached on launch (background applications) and those that aren't (foreground applications).

`launchspec`	Description
0	Launches all applications using the Connection Method defined for the application object.
1	Background applications use /bin/su. Foreground applications use the application object's Connection Method.
2	Background applications use the application object's Connection Method. Foreground applications use /bin/su.
3	Launches all applications using /bin/su.
4	Launches all applications using the Connection Method defined for the application object.
5	Background applications use /bin/sh. Foreground applications use the application object's Connection Method.
6	Background applications use the application object's Connection Method. Foreground applications use /bin/sh.
7	Launches all applications using /bin/sh.

The default is -user 1 -root 3.

Example

locallaunch -abort

Related topics
What are login scripts? Login scripts supplied with Secure Global Desktop The tarantella Tcl command