Home | Trees | Indices | Help |
|
---|
|
object --+ | X2goClient
The X2goClient implements _THE_ public Python X2go API. With it you can construct your own X2go client application in Python.
Most methods in this class require that you have registered a session with a remote X2go server (passing of session options, initialization of the session object etc.) and connected to it (authentication). For these two steps use these methods: X2goClient.register_session() and X2goClient.connect_session().
Instance Methods | |||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
bool
|
|
||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
str
|
|
||
str
|
|
||
str
|
|
||
str
|
|
||
list
|
|
||
str
|
|
||
|
|||
str
|
|
||
tuple |
|
||
str |
|
||
obj |
|
||
obj |
|
||
str or X2goSession instance
|
|
||
str
|
|
||
bool
|
|
||
bool
|
|
||
bool
|
|
||
bool
|
|
||
|
|||
|
|||
bool
|
|
||
bool
|
|
||
bool
|
|
||
bool
|
|
||
bool
|
|
||
str
|
|
||
str
|
|
||
bool
|
|
||
bool
|
|
||
bool
|
|
||
bool
|
|
||
bool
|
|
||
bool
|
|
||
list
|
|
||
list
|
|
||
list
|
|
||
list
|
|
||
list
|
|
||
X2goControlSession* instance
|
|
||
X2goSession or str
|
|
||
|
|||
list
|
|
||
list
|
|
||
list
|
|
||
bool
|
|
||
bool
|
|
||
str
|
|
||
list
|
|
||
bool
|
|
||
|
|||
list
|
|
||
|
|||
bool
|
|
||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
dict
|
|
||
dict
|
|
||
str
|
|
||
str
|
|
||
str
|
|
||
list
|
|
||
bool
|
|
||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
Inherited from |
Properties | |
has_custom_client_rootdir Does this X2goClient instance have a customized root dir path? Equals True in case it has.
|
|
client_has_connected_sessions Equals True if there are any connected sessions with
this X2goClient instance.
|
|
client_has_associated_sessions Equals True if there are any associated sessions with
this X2goClient instance.
|
|
client_has_running_sessions Equals True if there are any running sessions with this
X2goClient instance.
|
|
client_has_suspended_sessions Equals True if there are any suspended sessions with
this X2goClient instance.
|
|
client_control_sessions Equals a list of all registered X2go control sessions. |
|
profile_names Equals a list of all profile names that are known to this X2goClient instance. |
|
Inherited from |
Method Details |
x.__init__(...) initializes x; see help(type(x)) for signature
|
HOOK method: called if the Python X2go module could not find any usable XServer application to start. You will not be able to start X2go sessions without an XServer. |
HOOK method: called if an incoming print job has been detected by X2goPrintQueue and a print dialog box is requested.
|
HOOK: the command <cmd> is not available on the connected X2go server.
|
HOOK method: called on detection of an incoming MIME box job ,,<filename>''.
|
HOOK method: called if an incoming print job caused an error.
|
HOOK method: called if a host check is requested. This hook has to
either return
|
HOOK method: called if a control session (server connection) has unexpectedly encountered a failure.
|
HOOK method: called if a sound tunnel setup failed.
|
HOOK method: called if a reverse port forwarding request has been denied.
|
HOOK method: called if a port forwarding tunnel setup failed.
|
HOOK method: called if a session has been started by this instance of X2goClient.
|
HOOK method: called if a session has been started by another
|
HOOK method: called if a session has been resumed by this instance of X2goClient.
|
HOOK method: called if a session has been resumed by another
|
HOOK method: called after server connect if an already running session has been found.
|
HOOK method: called if a session has been suspended by this instance of X2goClient.
|
HOOK method: called if a session has been suspended by another
|
Retrieve the settings root directory of this X2goClient instance.
|
Retrieve the sessions root directory of this X2goClient instance.
|
Retrieve the SSH client root dir used with this X2goClient instance.
|
Query the local user's username (i.e. the user running the X2go client).
|
Register all session profiles found in the
|
Register a new X2goSession. Within one X2goClient instance you can manage several X2goSession instances on serveral remote X2go servers under different user names. These sessions can be instantiated by passing direct X2goSession
parameters to this method or by specifying the name of an existing
session profile (as found in the X2goClient's
A session profile is a pre-defined set of session options stored in a
sessions profile node (e.g. a configuration file). With the FILE backend
such session profiles are stored as a file (by default:
Python X2go also supports starting multiple X2go sessions for the same session profile simultaneously. This method (X2goClient.register_session()) accepts a similar set of parameters as the X2goSession constructor itself. For a complete set of session options refer there. Alternatively, you can also pass a profile name or a profile id to
this method. If you do this, Python X2go tries to find the specified
session in the
|
Retrieves a Python dictionary, containing a short session summary (session status, names, etc.)
|
After an X2goSession has been set up you can query the username that the remote sessions runs as.
|
After a session has been set up you can query the hostname of the host the session is connected to (or about to connect to).
|
Retrieve the server hostname as provided by the calling application (e.g. like it has been specified in the session profile).
|
Retrieve the complete X2goSession object that has been registered under the given session registry hash.
|
Alias for get_session().
|
Retrieve session UUID or X2goSession for session name <session_name> from the session registry.
|
Retrieve the server-side X2go session name for the session that has
been registered under
|
Set the session username for the X2goSession
that has been registered under
|
Provide a mechanism to evaluate the validity of an X2go server host.
|
Check if session with unique identifier <session_uuid> is configured adequately to be able to auto-connect to the X2go server (e.g. public key authentication).
|
Connect to a registered X2go session with registry hash
|
Disconnect an X2goSession by closing down its Paramiko/SSH Transport thread.
|
If X2go client-side printing is enable within an X2go session you can use this method to alter the way how incoming print spool jobs are handled/processed. Currently, there are five different print actions available, each defined as an individual print action class:
Each of the print action classes accepts different print action arguments. For detail information on these print action arguments please refer to the constructor methods of each class individually.
|
Start a new X2go session on the remote X2go server. This method will open---if everything has been successful till here---the X2go session window. Before calling this method you have to register your desired session with register_session (initialization of session parameters) and connect to it with connect_session (authentication).
|
Share another already running desktop session. Desktop sharing can be run in two different modes: view-only and full-access mode. Like new sessions a to-be-shared session has be registered first with the X2goClient instance.
|
Resume or continue a suspended / running X2go session on a remote X2go server (as specified when register_session was called).
|
Suspend an X2go session. Normally, you will use this method to suspend a registered session
that you have formerly started/resumed from within your recent X2goClient
instance. For this you simply call this method using the sessions
Alternatively, you can suspend a non-associated X2go session: To do
this you simply neeed to register (with the register_session method) an X2go session on the
to-be-addressed remote X2go server and connect (connect_session) to it. Then call this method with the
freshly obtained
|
Terminate an X2go session. Normally you will use this method to terminate a registered session
that you have formerly started/resumed from within your recent X2goClient
instance. For this you simply call this method using the sessions
Alternatively, you can terminate a non-associated X2go session: To do
this you simply neeed to register (register_session) an X2go session on the to-be-addressed
remote X2go server and connect (connect_session) to it. Then call this method with the
freshly obtained
|
Retrieve the profile name of the session that has been registered
under For profile based sessions this will be the profile name as used in x2goclient's »sessions« configuration file. For non-profile based session this will either be a
|
Retrieve the profile id of the session that has been registered under
For profile based sessions this will be the profile id as used in x2goclient's »sessions« configuration node (section header of a session profile in the config, normally a timestamp created on session profile creation/modification). For non-profile based sessions this will be a timestamp created on
X2go session registration by
|
Test if the X2go session registered as
|
Test if the X2go session registered as
|
Test if the X2go session registered as
|
Test if the X2go session registered as
|
Test if the X2go session registered as
|
Share a local folder with the X2go session registered as
When calling this method the given client-side folder is mounted on the X2go server (via sshfs) and (if in desktop mode) provided as a desktop icon on your remote session's desktop.
|
Retrieve a list of X2go sessions that this X2goClient instance is connected to.
|
Retrieve a list of X2go sessions associated to this X2goClient instance.
|
Retrieve a list of running X2go sessions.
|
Retrieve a list of suspended X2go sessions.
|
Retrieve a list of registered X2go sessions.
|
Retrieve control session for profile name <profile_name>.
|
Retrieve X2go session of a given session name.
|
Equals
|
Retrieve registered X2go sessions of profile name <profile_name>.
|
Retrieve connected X2go sessions of profile name <profile_name>.
|
Retrieve associated X2go sessions of profile name <profile_name>.
|
Test if server that corresponds to the terminal session
|
Test vitality of all connected X2go servers.
|
Check if user is allowed to start an X2go session on a remote server.
|
Retrieve a list of session names of all server-side running sessions (including those not instantiated by our X2goClient instance).
|
Equals
|
Equals
|
Retrieve a list of session names of all server-side suspended sessions (including those not instantiated by our X2goClient instance).
|
Equals
|
Equals
|
Find running X2go sessions that have previously been started by the connected user on the remote X2go server and terminate them. Before calling this method you have to setup a pro forma remote X2go session with X2goClient.register_session() (even if you do not intend to open a real X2go session window on the remote server) and connect to this session (with X2goClient.connect_session().
|
Use the X2go session registered under Before calling this method you have to setup a pro forma remote X2go session with X2goClient.register_session() (even if you do not intend to open a real X2go session window on the remote server) and connect to this session (with X2goClient.connect_session().
|
Use the X2go session registered under Before calling this method you have to setup a pro forma remote X2go session with X2goClient.register_session() (even if you do not intend to open a real X2go session window on the remote server) and connect to this session (with X2goClient.connect_session().
|
Returns the X2goClient instance's Use this method for object retrieval if you want to modify the »sessions« configuration node (e.g. in ~/.x2goclient with the FILE backend) from within your Python X2go based application. return: returns the client's session profiles instance rtype:
|
Alias for get_profiles(). |
Returns the X2goClient instance's Use this method for object retrieval if you want to modify the »settings« configuration node (e.g. in ~/.x2goclient with the FILE backend) from within your Python X2go based application. return: returns the client's settings configuration node rtype:
|
Returns the X2goClient instance's Use this method for object retrieval if you want to modify the printing configuration node (e.g. in ~/.x2goclient with the FILE backend) from within your Python X2go based application. return: returns the client's printing configuration node rtype:
|
Returns a dictionary with session options and values that represent
the session profile for
|
Returns a dictionary with session options and values that represent
the session profile for
|
Retrieve the session profile ID of the session whose profile name is
|
Retrieve the session profile name of the session whose profile ID is
|
Evaluate a session profile and return a human readable meta type
(classification) for the session profile
|
Retrieve a list of session profiles that are currently connected to an X2go server.
|
Disconnect all X2goSession instances that relate to
|
Update the session registry stati by profile name.
|
Update the session registry status of a specific X2goSession instance with session identifier <session_uuid>.
|
Update the session list cache by profile name.
|
Update the session list cache of a specific X2goSession instance with session identifier <session_uuid>.
|
Update the session list cache of all session profiles.
|
Register available sessions that are found on the X2go server the
profile of name
|
Register available sessions that are found on the X2go server that the X2goSession instance with session identifier <session_uuid> is connected to.
|
Property Details |
has_custom_client_rootdirDoes this X2goClient instance have a customized root dir path?
Equals
|
client_has_connected_sessionsEquals
|
client_has_associated_sessionsEquals
|
client_has_running_sessionsEquals
|
client_has_suspended_sessionsEquals
|
client_control_sessionsEquals a list of all registered X2go control sessions.
|
profile_namesEquals a list of all profile names that are known to this X2goClient instance.
|
Home | Trees | Indices | Help |
|
---|
Generated by Epydoc 3.0.1 on Sat Jul 9 21:01:09 2011 | http://epydoc.sourceforge.net |