D.19. tarantella emulatorsession list

Lists application sessions matching the criteria specified. Information shown includes session IDs, which are used with other tarantella emulatorsession commands.

An example session ID is paris.example.com:965127448604: ...%2f_ens%2fo=Example%2fcn=Emma Rald.

Session IDs can contain spaces, so make sure you quote them.

Syntax

tarantella emulatorsession list [ --person pobj ]
                                [ --application appobj ]
                                [ --appserver hobj ]
                                [ --server serv ]
                                [ --format text|count|xml ]

Description

The following table shows the available options for this command.

Option

Description

--person

Lists application sessions matching the name of the person specified.

Use the user identity of the person.

--application

Lists application sessions matching the name of application specified.

Use the name of an application object in the local repository.

--appserver

Lists application sessions matching the name of application server specified.

Use the name of an application server object in the local repository.

--server

Lists application sessions hosted by the SGD server specified.

Use the name of an application server object in the local repository (if the SGD server has an application server object), or the peer DNS name for the server.

--full

Includes the current IP address of the client and the status of the application session in the output. It takes longer to display this information.

--format

Specifies the output format. The default setting is text. Use count to display only the number of matching sessions.

If --person, --application, --appserver, and --server are all omitted, all application sessions are listed.

Examples

The following example lists Emma Rald's application sessions.

$ tarantella emulatorsession list \
--person "o=Example/cn=Emma Rald"

The following example lists all application sessions hosted by the SGD server boston.example.com. This is the server on which the Protocol Engines run.

$ tarantella emulatorsession list \
--server boston.example.com