Secure Global Desktop Administration Guide > Commands > The tarantella emulatorsession shadow command

The tarantella emulatorsession shadow command

Syntax

tarantella emulatorsession shadow sessid
                                  [--read-only]
                                  [--silent]
                                  [--format text|quiet]

Description

Shadows an emulator session, allowing you and the user to interact with the application simultaneously. Only Secure Global Desktop Administrators may shadow emulator sessions. You can only shadow Windows and X applications.

Note You can also shadow a session from the Sessions tab in Object Manager. You select the session from either the person object or the application object. However, Object Manager does not allow you to shadow a session in read-only mode or silent mode.

If --silent is not used, the user is notified that an Administrator wants to shadow their session and they can refuse permission. The user is also notified when shadowing ends.

Option	Description
`sessid`	Shadows the emulator session with the specified session ID. Use `tarantella emulatorsession list` to find out session IDs.
`--read-only`	Allows an Administrator to shadow a session without being able to interact with the application.
`--silent`	Allows an Administrator to shadow a session and interact with the application. The user is not notified that an Administrator wants to shadow their session and they can't refuse permission. If this is used with `--read-only`, the user does not know they are being shadowed and the Administrator can't interact with the application. Note In some countries, it is illegal to shadow a user without their knowledge. It is your responsibility to comply with the law.
`--format text \| quiet`	Specifies the output format (default: text). With `--format quiet`, no messages are displayed.

The exit code is 0 for success, 1 if the session doesn't exist, 2 if the session isn't shadowable, or 3 if the session is suspended.

Examples

tarantella emulatorsession shadow \
  "paris.indigo-insurance.com:965127448604:...%2f_ens%2fo=Indigo Insurance%2fcn=Emma Rald"

Shadows the emulator session with the specified session ID.

tarantella emulatorsession shadow \
  "paris.indigo-insurance.com:965127448604:...%2f_ens%2fo=Indigo Insurance%2fcn=Emma Rald" \
--read-only --silent

Shadows the emulator session with the specified session ID without the user knowing that they are being shadowed. The Administrator is unable to interact with the application.

Related topics
Using shadowing to troubleshoot a user's problem Using shadowing in the classroom Understanding webtop and emulator sessions The tarantella emulatorsession list command