User Commands gdmflexiserver(1)
NAME
gdmflexiserver - runs flexible (on demand) X servers
SYNOPSIS
gdmflexiserver [--authenticate] [--command=command] [--
debug] [--monte-carlo-pi] [--no-lock] [--xnest] [gnome-std-
options]
DESCRIPTION
gdmflexiserver runs flexible (on demand) X servers. gdmflex-
iserver allows a user to log in once and then quits. This is
useful if you are logged in as user A, and user B wants to
log in quickly but user A does not wish to log out. The X
server ensures that the virtual terminal switching works
transparently.
You can use gdmflexiserver to run a flexi-server as an
Xnest, that is, an X server in a window. If more than one
server is defined with flexible=true, a dialog is displayed
that lists all available flexible servers..
OPTIONS
The following options are supported:
-a, --authenticate Authenticate before running --
command.
-c, --command=command Send the specified protocol command
to GDM.
-d, --debug Debugging output.
--monte-carlo-pi
-l, --no-lock Do not lock current screen.
-n, --xnest Xnest mode.
gnome-std-options Standard options available for use
with most GNOME applications. See
gnome-std-options(5) for more infor-
mation.
SunOS 5.11 Last change: 1 Sep 2004 1
User Commands gdmflexiserver(1)
EXTENDED DESCRIPTION
gdmflexiserver accepts the following commands with the --
command option:
]o ADYNAMICDISPLAY
]o ALSERVERS
]o ATACHEDSERVERS
]o AUTHLOCAL
]o CLOSE
]o FLEXIXNEST
]o FLEXIXSERVER
]o GETCONFIG
]o GETCONFIGFILE
]o GETCUSTOMCONFIGFILE
]o GETSERVERDETAILS
]o GETSERVERLIST
]o GRETERPIDS
]o QUERYLOGOUTACTION
]o QUERYVT
]o RELEASEDYNAMICDISPLAYS
]o SERVERBUSY
]o SETLOGOUTACTION
]o SETSAFELOGOUTACTION
]o SETVT
]o UPDATECONFIG
]o VERSION
Each command is described in detail in the following sec-
tions.
SunOS 5.11 Last change: 1 Sep 2004 2
User Commands gdmflexiserver(1)
ADYNAMICDISPLAYS
Description: Create a new server definition that
will run on the specified display
leaving it in DISPLAYCONFIG state.
Supported since: 2.8.0.0
Arguments: display=server, where server is
either a configuration named in the
GDM configuration or a literal com-
mand name.
Answers:
]o OK
]o EROR error-number error-
description
0 Not
imple-
mented
2 Exist-
ing
display
3 No
server
string
4 Display
startup
failure
100 Not
authen-
SunOS 5.11 Last change: 1 Sep 2004 3
User Commands gdmflexiserver(1)
ticated
200 Too
many
mes-
sages
999 Unknown
error
ALSERVERS
Description: List all displays, including con-
sole, remote, Xnest. This can be
useful to figure out if the server
you are on is managed by the gdm
daemon, by seeing whether it is in
the list. It is also somewhat like
the 'w' command but for graphical
sessions.
Supported since: 2.4.2.96
Arguments: None
Answers:
]o OK server;server;...
]o server is display,logged-
in-user
]o logged-in-user can be
empty if no user is logged
in.
]o EROR error-number error-
description
SunOS 5.11 Last change: 1 Sep 2004 4
User Commands gdmflexiserver(1)
0 Not
imple-
mented
200 Too
many
mes-
sages
999 Unknown
error
ATACHEDSERVERS
Description: List all attached displays, Does not
list XDMCP and Xnest non-attached
displays. THis command used to be
named CONSOLESERVERS, which is
still recognized for backwards com-
patibility. The optional pattern
argument is supported as of version
2.8.0.0.
Supported since: 2.2.4.0
Arguments: pattern (Optional)
Answers:
]o OK server;server;...
]o server is display,logged-
in-user,vt-or-xnest-
display
]o logged-in-user can be
empty if no user is logged
in.
]o
SunOS 5.11 Last change: 1 Sep 2004 5
User Commands gdmflexiserver(1)
vt can be -1 if not known
or not supported. For
example, on non-Linux.
]o If the display is an Xnest
display and is a console
display (that is, an Xnest
inside another console
display), the display is
listed. Instead of vt,
lists the parent display
in standard form.
]o EROR error-number error-
description
0 Not
imple-
mented
200 Too
many
mes-
sages
999 Unknown
error
AUTHLOCAL
Description: Set up this connection as authenti-
cated for FLEXISERVER. All full-
blown (non-Xnest) servers can be
started only from users logged in
locally. Here, GDM assumes only
users logged in from GDM. Users must
pass the xauth MIT-MAGIC-COKIE-1
that they were passed before the
connection is authenticated.
Note: The AUTH LOCAL command
requires the --authenticate option,
although only FLEXIXSERVER uses
this currently.
SunOS 5.11 Last change: 1 Sep 2004 6
User Commands gdmflexiserver(1)
Note: Since 2.6.0.6 you can also use
a global ServAuthDir/.cookie, which
works for all authentication except
for SETLOGOUTACTION,
QUERYLOGOUTACTION, and
SETSAFELOGOUTACTION which require
a logged in display.
Supported since: 2.2.4.0
Arguments: xauth-cookie, in hex form with no 0x
prefix
Answers:
]o OK
]o EROR error-number error-
description
0 Not
imple-
mented
100 Not
authen-
ticated
200 Too
many
mes-
sages
999 Unknown
error
SunOS 5.11 Last change: 1 Sep 2004 7
User Commands gdmflexiserver(1)
CLOSE
Description: Close sockets connection
Supported since: 2.2.4.0
Arguments: None
Answers: None
FLEXIXNEST
Description: Start a new flexible Xnest server.
Supported since: 2.3.90.4
Note: Supported on older versions
from 2.2.4.0, later 2.2.4.2, but
since 2.3.90.4 you must supply four
arguments or EROR 100 will be
returned. This will start Xnest
using the XAUTHORITY file supplied
and with the same uid as the owner
of that file (and the same as you
supply). You must also supply the
cookie as the third argument for
this display, to prove that you
indeed are this user. Also, this
file must be readable ONLY by this
user, that is, have a mode of 0600.
If all of these conditions are not
met, EROR 100 is returned.
Note: The cookie should be the MIT-
MAGIC-COKIE-1, the first one that
GDM can find in the XAUTHORITY file
for this display. If that is not
what you use, you should generate
one first. The cookie should be in
hex form.
SunOS 5.11 Last change: 1 Sep 2004 8
User Commands gdmflexiserver(1)
Arguments: display-to-run-on uid-of-
requesting-user xauth-cookie-for-
the-display xauth-file
Answers:
]o OK display
]o EROR error-number error-
description
0 Not
imple-
mented
1 No more
flexi
servers
2 Startup
errors
3 X
failed
4 X too
busy
5 Xnest
can't
connect
6 No
server
binary
SunOS 5.11 Last change: 1 Sep 2004 9
User Commands gdmflexiserver(1)
100 Not
authen-
ticated
200 Too
many
mes-
sages
999 Unknown
error
FLEXIXSERVER
Description: Start a new X flexible server. Only
supported on connection that passed
AUTHLOCAL.
Supported since: 2.2.4.0
Arguments: xserver-type
If no argument specified, starts the
standard x server.
Answers:
]o OK display
]o EROR error-number error-
description
0 Not
imple-
mented
1 No more
flexi
SunOS 5.11 Last change: 1 Sep 2004 10
User Commands gdmflexiserver(1)
servers
2 Startup
errors
3 X
failed
4 X too
busy
6 No
server
binary
100 Not
authen-
ticated
200 Too
many
mes-
sages
999 Unknown
error
GETCONFIG
Description: Get configuration value for the
specified key. Useful so that other
applications can request configura-
tion information from GDM. Any key
defined as GDMKEY* in gdm.h is
supported. Starting with version
2.13.0.2 translated keys (such as
greeter/GdmWelcome[cs] are supported
SunOS 5.11 Last change: 1 Sep 2004 11
User Commands gdmflexiserver(1)
via GETCONFIG. Also starting with
version 2.13.0.2 it is no longer
necessary to include the default
value (i.e. you can use key
greeter/IncludeAll instead of having
to use greeter/IncludeAll=false.
Supported since: 2.6.0.9
Arguments: key
Answers:
]o OK value
]o EROR error-number error-
description
0 Not
imple-
mented
50 Unsup-
ported
key
200 Too
many
mes-
sages
999 Unknown
error
GETCONFIGFILE
Description: Get config file location used by the
daemon. If the GDM daemon was
SunOS 5.11 Last change: 1 Sep 2004 12
User Commands gdmflexiserver(1)
started with the --config option, it
will return the value passed in via
the argument.
Supported since: 2.8.0.2
Arguments: None
Answers:
]o OK full-path-to-config-file
]o EROR error-number error-
description
0 Not
imple-
mented
200 Too
many
mes-
sages
999 Unknown
error
GETCUSTOMCONFIGFILE
Description: Get custom config file location
being used by the daemon
Supported since: 2.14.0.0
Arguments: None
SunOS 5.11 Last change: 1 Sep 2004 13
User Commands gdmflexiserver(1)
Answers:
]o OK full-path-to-config-file
EROR error-number error-
description
0 Not
imple-
mented
1 File
not
found
200 Too
many
mes-
sages
999 Unknown
error
GETSERVERDETAILS
Description: Get detail information for a
specific server.
Supported since: 2.13.0.4
Arguments: server key
Valid key values include:
]o NAME: Returns the server name
]o COMAND: Returns the server
command
SunOS 5.11 Last change: 1 Sep 2004 14
User Commands gdmflexiserver(1)
]o FLEXIBLE: Returns "true" if
flexible, "false" otherwise
]o CHOSABLE: Returns "true" if
choosable, "false" otherwise
]o HANDLED: Returns "true" if han-
dled, "false" otherwise
]o CHOSER: Returns "true" if
chooser, "false" otherwise
]o PRIORITY: Returns process
priority
Answers:
]o OK value
]o EROR error-number error-
description
0 Not
imple-
mented
1 Server
not
found
2 Key not
valid
50 Unsup-
ported
key
200 Too
many
mes-
sages
SunOS 5.11 Last change: 1 Sep 2004 15
User Commands gdmflexiserver(1)
999 Unknown
error
GETSERVERLIST
Description: Get a list of the server sections
defined in the configuration file
Supported since: 2.13.0.4
Arguments: None
Answers:
]o OK full-path-to-config-file
]o EROR error-number error-
description
0 Not
imple-
mented
1 No
servers
found
50 Unsup-
ported
key
200 Too
many
mes-
sages
SunOS 5.11 Last change: 1 Sep 2004 16
User Commands gdmflexiserver(1)
999 Unknown
error
GRETERPIDS
Description: List all greeter pids so that one
can send HUP to them to re-read con-
fig. Only the root user can send
such a HUP.
Supported since: 2.3.90.2
Arguments: None
Answers:
]o OK pid;pid;...
]o EROR error-number error-
description
0 Not
imple-
mented
200 Too
many
mes-
sages
999 Unknown
error
QUERYLOGOUTACTION
Description: Query which logout actions are pos-
sible. Only supported on connection
that passed AUTHLOCAL.
SunOS 5.11 Last change: 1 Sep 2004 17
User Commands gdmflexiserver(1)
Supported since: 2.5.90.0
Arguments: None
Answers:
]o OK action;action;...
action is HALT, REBOT, or
SUSPEND. An empty list can also
be returned if no action is
possible. A '!' is appended to
an action if it was already set
with SETLOGOUTACTION or
SETSAFELOGOUTACTION. Note
that SETLOGOUTACTION has pre-
cedence over
SETSAFELOGOUTACTION.
]o EROR error-number error-
description
0 Not
imple-
mented
100 Not
authen-
ticated
200 Too
many
mes-
sages
999 Unknown
error
SunOS 5.11 Last change: 1 Sep 2004 18
User Commands gdmflexiserver(1)
QUERYVT
Description: Ask the daemon about the current
virtual terminal. This is useful for
logins that do not own /dev/console
but are still console logins. Only
supported on Linux currently, other-
wise will get EROR 8. This is also
the way to query whether VT support
is available in the daemon. Only
supported on connection that passed
AUTHLOCAL.
Supported since: 2.5.90.0
Arguments: None
Answers:
]o OK vt-number
]o EROR error-number error-
description
0 Not
imple-
mented
8 Virtual
termi-
nals
not
sup-
ported
100 Not
authen-
ticated
SunOS 5.11 Last change: 1 Sep 2004 19
User Commands gdmflexiserver(1)
200 Too
many
mes-
sages
999 Unknown
error
RELEASEDYNAMICDISPLAYS
Description: Release dynamic displays currently
in DISPLAYCONFIG state.
Supported since: 2.8.0.0
Arguments: display
Answers:
]o OK vt-number
]o EROR error-number error-
description
0 Not
imple-
mented
1 Bad
display
number
100 Not
authen-
ticated
SunOS 5.11 Last change: 1 Sep 2004 20
User Commands gdmflexiserver(1)
200 Too
many
mes-
sages
999 Unknown
error
REMOVEDYNAMICDISPLAYS
Description: Remove a dynamic display, killing
the session and purging the display
configuration
Supported since: 2.8.0.0
Arguments: display
Answers:
]o OK display
]o EROR error-number error-
description
0 Not
imple-
mented
1 Bad
display
number
100 Not
authen-
ticated
SunOS 5.11 Last change: 1 Sep 2004 21
User Commands gdmflexiserver(1)
200 Too
many
mes-
sages
999 Unknown
error
SERVERBUSY
Description: Returns true if half or more of the
daemon's sockets are busy, false
otherwise. Used by slave programs
which want to ensure they do not
overwhelm the sever.
Supported since: 2.13.0.8
Arguments: None
Answers:
]o OK true false
]o EROR error-number error-
description
0 Not
imple-
mented
200 Too
many
mes-
sages
999 Unknown
error
SunOS 5.11 Last change: 1 Sep 2004 22
User Commands gdmflexiserver(1)
SETLOGOUTACTION
Description: Tell the daemon to halt, reboot, or
suspend after slave process exits.
Only supported on connection that
passed AUTHLOCAL.
Supported since: 2.5.90.0
Arguments: action
action is one of the following:
]o NONE: Set exit action to 'none'
]o HALT: Set exit action to 'halt'
]o REBOT: Set exit action to
'reboot'
]o SUSPEND: Set exit action to
'suspend'
Answers:
]o OK
]o EROR error-number error-
description
0 Not
imple-
mented
7 Unknown
logout
action,
or not
avail-
able
SunOS 5.11 Last change: 1 Sep 2004 23
User Commands gdmflexiserver(1)
100 Not
authen-
ticated
200 Too
many
mes-
sages
999 Unknown
error
SETSAFELOGOUTACTION
Description: Tell the daemon to halt, reboot, or
suspend after all users log out. If
only one person logs out, this is
the same as SETLOGOUTACTION. Note
that SETLOGOUTACTION has precen-
dence over SETSAFELOGOUTACTION if
set to something other than NONE.
If no user is logged in, the action
takes effect immediately. Only sup-
ported on connection that passed
AUTHLOCAL.
Supported since: 2.5.90.0
Arguments: action
action is one of the following:
]o NONE: Set exit action to 'none'
]o HALT: Set exit action to 'halt'
]o REBOT: Set exit action to
'reboot'
]o SUSPEND: Set exit action to
'suspend'
SunOS 5.11 Last change: 1 Sep 2004 24
User Commands gdmflexiserver(1)
Answers:
]o OK
]o EROR error-number error-
description
0 Not
imple-
mented
7 Unknown
logout
action,
or not
avail-
able
100 Not
authen-
ticated
200 Too
many
mes-
sages
999 Unknown
error
SETVT
Description: Change to the specified virtual ter-
minal. This is useful for logins
that do not own /dev/console but are
still console logins. Only supported
on Linux currently, otherwise will
get EROR 8. Only supported on con-
nection that passed AUTHLOCAL.
SunOS 5.11 Last change: 1 Sep 2004 25
User Commands gdmflexiserver(1)
Supported since: 2.5.90.0
Arguments: vt
Answers:
]o OK
]o EROR error-number error-
description
0 Not
imple-
mented
8 Virtual
termi-
nals
not
sup-
ported
9 Invalid
virtual
termi-
nal
number
100 Not
authen-
ticated
200 Too
many
mes-
sages
SunOS 5.11 Last change: 1 Sep 2004 26
User Commands gdmflexiserver(1)
999 Unknown
error
UPDATECONFIG
Description: Tell the daemon to update the confi-
guration of the specified key. Any
user can request that values are
re-read but the daemon will only do
so if the file has been modified
since GDM first read the file. Only
users who can change the GDM confi-
guration file (normally writable
only by the root user) can actually
modify the GDM configuration. This
command is useful to cause the GDM
to update itself to recognize a
change made to the GDM configuration
file by the root user.
Supported with limited keys since
2.3.90.2. Starting with version
2.13.0.0, all GDM keys are supported
except for the following:
]o daemon/PidFile
]o daemon/ConsoleNotify
]o daemon/User
]o daemon/Group
]o daemon/ServAuthDir
]o daemon/UserAuthDir
]o daemon/UserAuthFile
]o daemon/UserAuthFBDir
GDM also supports the following
psuedokeys:
]o xdmcp/PARAMETERS - All xdmcp
keys
]o xservers/PARAMETERS - all
[server-foo] sections
SunOS 5.11 Last change: 1 Sep 2004 27
User Commands gdmflexiserver(1)
Arguments: key
key is the base part of the key such
as "security/AllowRemoteRoot"
Answers:
]o OK
]o EROR error-number error-
description
0 Not
imple-
mented
50 Unsup-
ported
key
200 Too
many
mes-
sages
999 Unknown
error
VERSION
Description: Query GDM version
Supported since: 2.2.4.0
Arguments: None
SunOS 5.11 Last change: 1 Sep 2004 28
User Commands gdmflexiserver(1)
Answers:
]o GDM gdm-version
]o EROR error-number error-
description
200 Too
many
mes-
sages
999 Unknown
error
EXAMPLES
Example 1: To See Console GDM Version
example% gdmflexiserver --command=VERSION
GDM 2.6.0.2
Example 2: To See All Servers
example% gdmflexiserver --command=ALSERVERS
OK :0,username
Example 3: To See Console Servers
example% gdmflexiserver --command=ATACHEDSERVERS
OK :0,username,-1
FILES
The following files are used by this application:
/usr/bin/gdmflexiserver Executable for flexible (on demand)
X servers
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 1 Sep 2004 29
User Commands gdmflexiserver(1)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWgnome-display-mgr
Interface stability Volatile
SEE ALSO
Latest version of the GNOME Desktop User Guide for your
platform.
gdmXnestchooser(1), gdmdynamic(1), gdmphotosetup(1),
gdmthemetester(1), gdm(1m), gdm-restart(1m), gdmsetup(1m),
attributes(5), gnome-std-options(5)
NOTES
Original man page written by Martin K. Petersen
, George Lebl . Copyright (c)
1998, 1999 by Martin K. Petersen. Copyright (c) 2001, 2003,
2004 by George Lebl. Copyright (c) 2003 by Red Hat, Inc.
Updated by Brian Cameron, Sun Microsystems Inc., 2004, 2006.
SunOS 5.11 Last change: 1 Sep 2004 30
|
