gnome-std-options.5(5) Headers, Tables, and Macros gnome-std-options.5(5)NAMEgnome-std-options - standard options available for most GNOME applica‐
tions
DESCRIPTION
GNOME standard options which are available for most GNOME based appli‐
cations. Some of these options are only available if the program makes
use of various GNOME interfaces such as GTK+, Bonobo Activation, libg‐
nome, libgnomeui, or GNOME session. Use the --help option to see which
arguments are supported by any given program.
OPTIONS
The following options are supported:
-?, --help
Display detailed usage message.
--help-all
Display all help options.
--usage
Display a brief usage message.
The following GTK+ options are supported.
--help-gtk
Display GTK+ help options.
--class=class
Set the class of a GTK+ program, for use by the window manager.
--display=display
Specify an X Display to use, where display is in the following for‐
mat:
hostname:displaynumber.screennumber
--g-fatal-warnings
Make all GTK+ warnings fatal. This will cause the application to be
killed when a warning is issued, rather than reporting this warning
to
sdterr.
--gdk-debug=flags
Specify a list of GDK debug flags to set, in addition to those
specified in the GDK_DEBUG environment variable. This option is
only available if GTK+ has been configured with the --enable-
debug=yes option. Valid flags values are as follows:
· all
· dnd
· events
· misc
· xim
For more information, please refer to the GTK+ source code.
--gdk-no-debug=flags
Specify a list of GDK debug flags to unset. This option is only
available if GTK+ has been configured with the --enable-debug=yes
option. Valid flags values are the same as for the --gdk-debug
option. For more information, please refer to the GTK+ source code.
--gtk-debug=flags
Specify a list of GTK+ options to set, in addition to those speci‐
fied in the GTK_DEBUG environment variable. This option is only
available if GTK+ has been configured with the --enable-debug=yes
option. Valid flags values are as follows:
· all
· geometry
· icontheme
· keybindings
· misc
· modules
· multihead
· plugsocket
· printing
· text
· tree
· updates
For more information, please refer to the GTK+ source code.
--gtk-no-debug=flags
Specify a list of GTK+ options to unset. This option is only avail‐
able if GTK+ has been configured with --enable-debug=yes option.
Valid flags values are the same as for the --gtk-debug option. For
more information, please refer to the GTK+ source code.
--gtk-module=module
Specify a list of GTK+ modules to load, in addition to those
specifed in the GTK_MODULES environment variable.
--gxid-host=host
Specify a host on which to connect the gxid daemon. This option
overrides the GXID_HOST environment variable. This option is only
available if GTK+ has been configured with the --gdk-target=x11
option. gxid is the GNOME X Input Daemon, which is distributed as
part of GTK+.
--gxid-port=port
Specify a port for the connection to the gxid daemon. This option
overrides the GXID_PORT environment variable. This option is only
available if GTK+ has been configured with the --gdk-target=x11
option. gxid is the GNOME X Input Daemon, which is distributed as
part of GTK+.
--name=name
Set the name of a GTK+ program, for use by the window manager.
--screen=screen
Specify an X Screen to use. This is only useful if more than one
physical monitor is available. The default screen is 0. screen is
an integer value in the range 0 to {NumberOfScreens - 1}.
--sync
Specify that requests to the X Server should be sent synchronously.
By default, such requests are sent asynchronously. This option is
generally used when debugging an application, and should not be
used in normal execution.
The following Bonobo Activation options are supported.
--help-bonobo-activation
Display Bonobo Activation help options.
--oaf-activate-iid=iid
Specify an IID to activate.
--oaf-ior-fd=fd
Specify a File Descriptor on which to print IOR.
--oaf-private
Prevent registering of server with OAF.
The following GNOME options are supported.
--help-gnome
Display GNOME options.
--disable-sound
Disable sound server usage.
--enable-sound
Enable sound server usage.
--espeaker=hostname:port
Specify the location of the sound server to use.
--version
Print the version information for the command. You can also use -v
to specify this option.
The following GNOME GUI options are supported.
--help-gnome-ui
Display GNOME GUI help options.
--disable-crash-dialog
Disable the crash dialog.
The following GNOME session options are supported.
--help-gnome-session
Display session management help options.
--sm-client-id=id
Specify a session management ID.
--sm-config-prefix=prefix
Specify the prefix of a saved configuration.
--sm-disable
Disable the connection to the session manager.
Common application options that are supported.
--geometry=geometry
Specify the X geometry location for the application being launched,
where geometry is in the following format:
widthxheight+xoff+yoff
EXAMPLES
Example 1: Getting gnome-calculator usage
example% gnome-calculator -usage
Example 2: Launching ghex2 on host "Labrynth" with display 0 and screen
0
example% ghex2 --display=Labrynth:0.0
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables:
DISPLAY X Display on which the application should dis‐
play.
G_DEBUG This variable can be set to a list of debug
options. Set to fatal_warnings to make pro‐
grams abort at the first call to g_warning() or
g_critical(). Set to fatal_criticals to abort
at the first call to g_critical(). Set to gc-
friendly to cause newly allocated memory that
isn't directly initialized, as well as memory
being freed to be reset to 0. Set to resident-
modules to cause all modules loaded by GModule
to be made resident. Set to bind-now-modules
to cause all modules loaded by GModule to bind
their symbols at load time, even if the code
uses %G_MODULE_BIND_LAZY.
GDK_DEBUG If GTK+ has been configured with the --enable-
debug=yes option, this variable can be set to a
list of debug options that should be set for
GDK. Refer to the --gdk-option option for more
information.
GTK_DEBUG If GTK+ has been configured with the --enable-
debug=yes option, this variable can be set to a
list of debug options that should be set for
GTK. Refer to the --gtk-debug option for for
more information.
GTK_MODULES A list of GTK+ modules to load.
GTK_PATH A list of directories to search when GTK+ is
looking for dynamically loaded objects such as
the modules specified by GTK_MODULES, theme
engines, input method modules, file system
backends, and print backends.
GXID_HOST Host to which the gxid daemon should connect.
GXID_PORT Port for the connection to the gxid daemon.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWgnome-* │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOgnome-session(1), libbonobo-activation(3), libgdk-x11-2.0(5),
libglib-2.0(5), libgnome-2(3), libgnomeui-2(3), libgtk-x11-2.0(5),
attributes(5), environ(5), gnome-interfaces(5), X(5)
GTK+ source code
Latest version of the GNOME Desktop User Guide for your platform.
NOTES
Written by Matt Keenan, Sun Microsystems Inc., 2003, 2006, 2007.
SunOS 5.11 12 Nov 2007 gnome-std-options.5(5)