gnome-std-options.5(5) Headers, Tables, and Macros gnome-std-options.5(5)
NAME
gnome-std-options - standard options available for most GNOME applications
DESCRIPTION
GNOME standard options which are available for most GNOME based applications. Some of these options are only available if the program
makes use of various GNOME interfaces such as GTK+, Bonobo Activation, libgnome, 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 format:
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:
o all
o dnd
o events
o misc
o 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 specified in the GTK_DEBUG environment variable. This option is only avail-
able if GTK+ has been configured with the --enable-debug=yes option. Valid flags values are as follows:
o all
o geometry
o icontheme
o keybindings
o misc
o modules
o multihead
o plugsocket
o printing
o text
o tree
o 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 available 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 display.
G_DEBUG This variable can be set to a list of debug options. Set to fatal_warnings to make programs 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_MOD-
ULE_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 ALSO
gnome-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)