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 avail-
able 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:
SunOS 5.11 Last change: 12 Nov 2007 1
Headers, Tables, and Macros gnome-std-options.5(5)
hostname:displaynumber.screennumber
--g-fatal-warnings
Make all GTK] warnings fatal. This will cause the appli-
cation 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 GDKDEBUG environment variable.
This option is only available if GTK] has been config-
ured 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 informa-
tion, 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 GTKDEBUG environment variable.
This option is only available if GTK] has been
SunOS 5.11 Last change: 12 Nov 2007 2
Headers, Tables, and Macros gnome-std-options.5(5)
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 informa-
tion, 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 GTKMODULES environment variable.
--gxid-host=host
SunOS 5.11 Last change: 12 Nov 2007 3
Headers, Tables, and Macros gnome-std-options.5(5)
Specify a host on which to connect the gxid daemon.
This option overrides the GXIDHOST environment vari-
able. 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 GXIDPORT environment vari-
able. 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 asyn-
chronously. This option is generally used when debugging
an application, and should not be used in normal execu-
tion.
The following Bonobo Activation options are supported.
--help-bonobo-activation
Display Bonobo Activation help options.
SunOS 5.11 Last change: 12 Nov 2007 4
Headers, Tables, and Macros gnome-std-options.5(5)
--oaf-activate-iid=iid
Specify an ID 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.
SunOS 5.11 Last change: 12 Nov 2007 5
Headers, Tables, and Macros gnome-std-options.5(5)
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 for-
mat:
widthxheight]xoff]yoff
SunOS 5.11 Last change: 12 Nov 2007 6
Headers, Tables, and Macros gnome-std-options.5(5)
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.
GDEBUG This variable can be set to a list
of debug options. Set to
fatalwarnings to make programs
abort at the first call to
gwarning() or gcritical(). Set to
fatalcriticals to abort at the
first call to gcritical(). Set to
gc-friendly to cause newly allocated
memory that isn't directly initial-
ized, 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 %GMODULEBINDLAZY.
GDKDEBUG 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.
GTKDEBUG 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
SunOS 5.11 Last change: 12 Nov 2007 7
Headers, Tables, and Macros gnome-std-options.5(5)
GTK. Refer to the --gtk-debug
option for for more information.
GTKMODULES A list of GTK] modules to load.
GTKPATH A list of directories to search when
GTK] is looking for dynamically
loaded objects such as the modules
specified by GTKMODULES, theme
engines, input method modules, file
system backends, and print backends.
GXIDHOST Host to which the gxid daemon should
connect.
GXIDPORT Port for the connection to the gxid
daemon.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE 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.
SunOS 5.11 Last change: 12 Nov 2007 8
Headers, Tables, and Macros gnome-std-options.5(5)
NOTES
Written by Matt Keenan, Sun Microsystems Inc., 2003, 2006,
2007.
SunOS 5.11 Last change: 12 Nov 2007 9
|
