Skip past navigation linksSecure 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

Skip past command syntax or program codeauthrequest [ -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

Skip past command syntax or program codeauthrequest -normal

setbuffer

Syntax

Skip past command syntax or program codesetbuffer [ -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

Skip past command syntax or program codesetbuffer -buffer 1000

clienttimer

Syntax

Skip past command syntax or program codeclienttimer [ time ] [ message ] [ timers ]

Description

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

Example

Skip past command syntax or program codeclienttimer 10 "Launching the application" 4

canceltimer

Syntax

Skip past command syntax or program codecanceltimer

Description

Cancels the clienttimer command. Takes no arguments.

progress

Syntax

Skip past command syntax or program codeprogress [ message ]

Description

Displays message in the progress dialog box.

Example

Skip past command syntax or program codeprogress "Initializing..."

locallaunch

Syntax

Skip past command syntax or program codelocallaunch [ -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

Skip past command syntax or program codelocallaunch -abort
Related topics