gnome-terminal(1) User Commands gnome-terminal(1)
NAME
gnome-terminal - terminal emulator for GNOME
SYNOPSIS
gnome-terminal [--tab] [--window] [--tab-with-profile=profilename] [--window-with-profile=profilename] [--active] [--command=command]
[--execute=command] [--full-screen] [--role=role] [--show-menubar | --hide-menubar] [--startup-id=id] [--title=title] [--use-factory |
--disable-factory] [--zoom=zoomfactor] [gnome-std-options]
DESCRIPTION
gnome-terminal is the GNOME terminal emulation program. It provides access to the UNIX shell on the GNOME environment. gnome-terminal sup-
ports multiple profiles to allow easy switching between preferences, and supports tabbing so that multiple terminals can be managed from a
single window. By default, all GNOME terminals share a single process, reducing memory usage. This can be disabled by starting gnome-ter-
minal with the --disable-factory option.
OPTIONS
The following options are supported:
--active
Set the last specified tab as the active one in its window.
-e, --command command
Executes the command command instead of the shell. This saves some memory if you just plan to run a dedicated application on that win-
dow.
--disable-factory
Do not register with the activation name server, and do not reuse an already running GNOME terminal process.
-x, --execute command
This option is provided for compatibility reasons. It is the same as the --command option.
--full-screen
Set the last-specified window into fullscreen mode. Applies to only one window. Can be specified one for each wwindow you create from
the command line.
--hide-menubar
Hide the menubar. This applies only to one window. When used with multiple --window-with-profile options, it applies to the --window-
with-profile option immediately to the left. Can be specified multiple times, once for each --window-with-profile option.
--role=role
The GNOME session manager follows the ICCCM convention of using the window title and the window role to identify specific windows. The
session manager uses this information to put windows back in the same place when the user restarts their session. If all windows have a
unique title, there is no need to set the role. However, as it is common for multiple GNOME terminals to have the same title, the user
can also specify the role on the command line with the --role option. This helps the session manager to properly identify and restart
each GNOME terminal (in the same location, and so on). When used with multiple --window-with-profile options, it applies to the
--window-with-profile option immediately to the left. Can be specified multiple times, once for each --window-with-profile option.
--show-menubar
Show the menubar. This applies only to one window. When used with multiple --window-with-profile options, it applies to the --window-
with-profile option immediately to the left. Can be specified multiple times, once for each --window-with-profile option.
--startup-id=id
Set the id for startup notification protocol.
--tab
Open a new tab in the last-opened window with the default profile. More than one of these options can be provided.
--tab-with-profile=profilename
Creates a tab that uses the specified profile. This argument may be specified multiple times to create multiple tabs in a terminal. If
this is used with multiple --window-with-profile options, the tab is created for the window that corresponds to the --window-with-pro-
file option immediately to the left.
-t, --title=title
Set the title for the GNOME terminal to be title.
--use-factory
Register with the activation name server, and reuse an already running GNOME terminal process.
--window
Open a new window contianing a tab with the default profile. More than one of these options can be provided.
--window-with-profile=profilename
Creates a GNOME terminal and a tab that uses the specified profile. This may be used with the --tab-with-profile option to create addi-
tional tabs. Multiple --window-with-profile options can be specified to create multiple GNOME terminal windows. All options specified
after an --window-with-profile option apply to that --window-with-profile option only.
--working-directory=dirname
Set the working directory for the GNOME terminal to be dirname.
--zoom=zoomfactor
Set the terminal's zoom factor (1.0 = normal size).
gnome-std-options
Standard options available for use with most GNOME applications. See gnome-std-options(5) for more information.
EXTENDED DESCRIPTION
gnome-terminal is designed to emulate the xterm program provided by the X Consortium. The xterm(1) program in turn is an almost-complete
emulation of the DEC VT102 terminal. gnome-terminal supports the same extensions to the VT102 as those provided by the xterm program,
through special escape sequences. The xterm program is an evolving program. Recent changes to xterm have been been incorporated into gnome-
terminal. This includes emulation of the newer DEC VT220 escape sequences.
EXAMPLES
Example 1: Running the `minicom' terminal emulator on the window
example% gnome-terminal --command minicom
Example 2: Monitoring the system
example% gnome-terminal --command top
Example 3: Starting two windows with different profiles
example% gnome-terminal --window-with-profile=FirstProfile
--tab-with-profile=SecondProfile --window-with-profile=SecondProfile
In this example, the first window will have two tabs (FirstProfile and SecondProfile) and the second window will have one tab (SecondPro-
file).
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables, set by gnome-terminal:
TERM This variable is set to xterm by default. Some implementations of curses, and applications based on curses, may
prefer the value to be xterm-color, color-xterm, or xterm-debian to support color. Users might need to change this
setting to one of these values to enable color for such applications.
COLORTERM This variable is set to xterm. Various applications (especially the Slang-based applications) use this setting to
determine whether the terminal supports color.
WINDOWID This variable contains the X11 Window identifier. This is sometimes used by applications to modify the contents of
this window or provide special effects.
EXIT STATUS
The following exit values are returned:
0 Application exited successfully
>0 Application exited with failure
FILES
The following files are used by this application:
/usr/bin/gnome-terminal Executable for GNOME terminal emulator
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWgnome-terminal |
+-----------------------------+-----------------------------+
|Interface stability |Volatile |
+-----------------------------+-----------------------------+
SEE ALSO
gnome-session(1), xterm(1), vte(1), libvte(3), attributes(5), environ(5) gnome-std-options(5)
Latest version of the GNOME Desktop User Guide for your platform.
NOTES
Written by Michael Zucchi, Miguel de Icaza, Erik Troan.
Updated by Brian Cameron, Sun Microsystems Inc., 2003, 2004, 2006.
SunOS 5.11 31 Aug 2004 gnome-terminal(1)