10139N/A<!
DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->
10139N/A<!
ENTITY suncopy "Copyright (c) 2003,2004,2006 Sun Microsystems, Inc. All Rights Reserved.">
10139N/A<
refentry id="gnome-terminal-1">
10139N/A<
refmeta><
refentrytitle>gnome-terminal</
refentrytitle><
manvolnum>1</
manvolnum>
10139N/A<
refmiscinfo class="date">31 Aug 2004</
refmiscinfo>
10139N/A<
refmiscinfo class="sectdesc">&man1;</
refmiscinfo>
10139N/A<
refmiscinfo class="software">&release;</
refmiscinfo>
10139N/A<
refmiscinfo class="arch">generic</
refmiscinfo>
10139N/A<
refmiscinfo class="copyright">&suncopy;</
refmiscinfo>
10139N/A<
indexterm><
primary>gnome-terminal</
primary></
indexterm><
indexterm><
primary>
10139N/Aterminal emulator for GNOME</
primary></
indexterm>
10139N/A<
refnamediv id="gnome-terminal-1-name"><
refname>gnome-terminal</
refname><
refpurpose>
10139N/Aterminal emulator for GNOME</
refpurpose></
refnamediv>
10139N/A<
refsynopsisdiv id="gnome-terminal-1-synp"><
title>&synp-tt;</
title>
10139N/A<
cmdsynopsis><
command>&cmd;</
command>
10139N/A<
arg choice="opt"><
option>-tab</
option></
arg>
11904N/A<
arg choice="opt"><
option>-window</
option></
arg>
10139N/A<
arg choice="opt"><
option>-tab-with-profile=<
replaceable>profilename</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-window-with-profile=<
replaceable>profilename</
replaceable></
option></
arg>
11904N/A<
arg choice="opt"><
option>-active</
option></
arg>
10139N/A<
arg choice="opt"><
option>-command=<
replaceable>command</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-execute=<
replaceable>command</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-full-screen</
option></
arg>
15997N/A<
arg choice="opt"><
option>-maximize</
option></
arg>
10139N/A<
arg choice="opt"><
option>-role=<
replaceable>role</
replaceable></
option></
arg>
10139N/A<
group><
arg choice="plain"><
option>-show-menubar </
option></
arg>
10139N/A<
arg choice="plain"><
option>-hide-menubar</
option></
arg></
group>
10139N/A<
arg choice="opt"><
option>-startup-id=<
replaceable>id</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option>-title=<
replaceable>title</
replaceable></
option></
arg>
10139N/A<
group><
arg choice="plain"><
option>-use-factory</
option></
arg>
10139N/A<
arg choice="plain"><
option>-disable-factory</
option></
arg></
group>
15997N/A<
arg choice="opt"><
option>-working-directory=<
replaceable>dirname</
replaceable></
option></
arg>
11904N/A<
arg choice="opt"><
option>-zoom=<
replaceable>zoomfactor</
replaceable></
option></
arg>
10139N/A<
arg choice="opt"><
option role="nodash"><
replaceable>gnome-std-options</
replaceable></
option></
arg>
10139N/A<
refsect1 id="gnome-terminal-1-desc"><
title>&desc-tt;</
title>
10139N/A<
para><
command>&cmd;</
command> is the GNOME terminal emulation program. It
10139N/Aprovides access to the UNIX shell on the GNOME environment. <
command>&cmd;</
command>
10139N/Asupports multiple profiles to allow easy switching between preferences, and
10139N/Asupports tabbing so that multiple terminals can be managed from a single window.
10139N/ABy default, all GNOME terminals share a single process, reducing memory usage.
10139N/AThis can be disabled by starting <
command>&cmd;</
command> with the <
option>
10139N/A-disable-factory</
option> option.</
para>
10139N/A<
refsect1 id="gnome-terminal-1-opts"><
title>&opts-tt;</
title>
10139N/A<
para>The following options are supported:</
para>
10139N/A<
variablelist termlength="wholeline">
11904N/A<
varlistentry><
term><
option>-active</
option></
term><
listitem><
para>
11904N/ASet the last specified tab as the active one in its window.
10139N/A<
varlistentry><
term><
option>e</
option>, <
option>-command <
replaceable>command</
replaceable></
option></
term>
10139N/A<
listitem><
para>Executes the command <
filename><
replaceable>command</
replaceable></
filename>
10139N/Ainstead of the shell. This saves some memory if you just plan to run a dedicated
10139N/Aapplication on that window.</
para>
10139N/A<
varlistentry><
term><
option>-disable-factory</
option></
term><
listitem><
para>
10139N/ADo not register with the activation name server, and do not reuse an already
10139N/Arunning GNOME terminal process.</
para>
10139N/A<
varlistentry><
term><
option>x</
option>, <
option>-execute <
replaceable>command</
replaceable></
option></
term>
10139N/A<
listitem><
para>This option is provided for compatibility reasons. It is the
10139N/Asame as the <
option>-command</
option> option.</
para>
10139N/A<
varlistentry><
term><
option>-full-screen</
option></
term>
10139N/A<
listitem><
para>Set the last-specified window into fullscreen mode. Applies to
10139N/Aonly one window. Can be specified one for each wwindow you create from the
15997N/A<
varlistentry><
term><
option>-maximize</
option></
term>
15997N/ASet the last-specified window into maximized mode; a pplies to only one window;
15997N/Acan be specified once for each window you create from the command line.
10139N/A<
varlistentry><
term><
option>-hide-menubar</
option></
term><
listitem><
para>
10139N/AHide the menubar. This applies only to one window. When used with multiple <
option>
10139N/A-window-with-profile</
option> options, it applies to the <
option>-window-with-profile
10139N/A</
option> option immediately to the left. Can be specified multiple times,
10139N/Aonce for each <
option>-window-with-profile</
option> option.</
para>
10139N/A<
varlistentry><
term><
option>-role=<
replaceable>role</
replaceable></
option></
term>
10139N/A<
listitem><
para>The GNOME session manager follows the ICCCM convention of
10139N/Ausing the window title and the window role to identify specific windows. The
10139N/Asession manager uses this information to put windows back in the same place
10139N/Awhen the user restarts their session. If all windows have a unique title,
10139N/Athere is no need to set the role. However, as it is common for multiple GNOME
10139N/Aterminals to have the same title, the user can also specify the role on the
10139N/Acommand line with the <
option>-role</
option> option. This helps the session
10139N/Amanager to properly identify and restart each GNOME terminal (in the same
10139N/Alocation, and so on). When used with multiple <
option>-window-with-profile
10139N/A</
option> options, it applies to the <
option>-window-with-profile</
option>
10139N/Aoption immediately to the left. Can be specified multiple times, once for
10139N/Aeach <
option>-window-with-profile</
option> option.</
para>
10139N/A<
varlistentry><
term><
option>-show-menubar</
option></
term><
listitem><
para>
10139N/AShow the menubar. This applies only to one window. When used with multiple <
option>
10139N/A-window-with-profile</
option> options, it applies to the <
option>-window-with-profile
10139N/A</
option> option immediately to the left. Can be specified multiple times,
10139N/Aonce for each <
option>-window-with-profile</
option> option.</
para>
10139N/A<
varlistentry><
term><
option>-startup-id=<
replaceable>id</
replaceable></
option></
term>
10139N/A<
listitem><
para>Set the <
replaceable>id</
replaceable> for startup notification
10139N/A<
varlistentry><
term><
option>-tab</
option></
term><
listitem><
para>
10139N/AOpen a new tab in the last-opened window with the default profile. More than
10139N/Aone of these options can be provided.</
para>
10139N/A<
varlistentry><
term><
option>-tab-with-profile=<
replaceable>profilename</
replaceable></
option></
term>
10139N/A<
listitem><
para>Creates a tab that uses the specified profile. This argument
10139N/Amay be specified multiple times to create multiple tabs in a terminal. If
10139N/Athis is used with multiple <
option>-window-with-profile</
option> options,
10139N/Athe tab is created for the window that corresponds to the <
option>-window-with-profile
10139N/A</
option> option immediately to the left.</
para>
10139N/A<
varlistentry><
term><
option>t</
option>, <
option>-title=<
replaceable>title</
replaceable></
option></
term>
10139N/A<
listitem><
para>Set the title for the GNOME terminal to be <
replaceable>title
10139N/A<
varlistentry><
term><
option>-use-factory</
option></
term><
listitem><
para>Register
10139N/Awith the activation name server, and reuse an already running GNOME terminal
10139N/A<
varlistentry><
term><
option>-window</
option></
term><
listitem><
para>
11925N/AOpen a new window contianing a tab with the default profile. More than one of
10139N/Athese options can be provided.</
para>
10139N/A<
varlistentry><
term><
option>-window-with-profile=<
replaceable>profilename
10139N/A</
replaceable></
option></
term><
listitem><
para>Creates a GNOME terminal and
10139N/Aa tab that uses the specified profile. This may be used with the <
option>
10139N/A-tab-with-profile</
option> option to create additional tabs. Multiple <
option>
10139N/A-window-with-profile</
option> options can be specified to create multiple
10139N/AGNOME terminal windows. All options specified after an <
option>-window-with-profile
10139N/A</
option> option apply to that <
option>-window-with-profile</
option> option
10139N/A<
varlistentry><
term><
option>-working-directory=<
replaceable>dirname</
replaceable></
option></
term>
10139N/A<
listitem><
para>Set the working directory for the GNOME terminal to be <
replaceable>
11904N/A<
varlistentry><
term><
option>-zoom=<
replaceable>zoomfactor</
replaceable></
option></
term>
10139N/A<
listitem><
para>Set the terminal's zoom factor (1.0 = normal size).</
para>
10139N/A<
varlistentry><
term><
option role="nodash"><
replaceable>gnome-std-options</
replaceable></
option></
term>
10139N/A<
listitem><
para>Standard options available for use with most GNOME applications.
10139N/ASee <
citerefentry><
refentrytitle>gnome-std-options</
refentrytitle><
manvolnum>
10139N/A5</
manvolnum></
citerefentry> for more information.</
para>
10139N/A<
refsect1 id="gnome-terminal-1-exde"><
title>&exde-tt;</
title>
10139N/A<
para><
command>&cmd;</
command> is designed to emulate the <
filename>xterm
10139N/A</
filename> program provided by the X Consortium. The <
citerefentry><
refentrytitle>
10139N/Axterm</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry> program in turn
10139N/Ais an almost-complete emulation of the DEC VT102 terminal. <
command>&cmd;</
command>
10139N/Asupports the same extensions to the VT102 as those provided by the <
filename>
10139N/Axterm</
filename> program, through special escape sequences. The <
filename>
10139N/Axterm</
filename> program is an evolving program. Recent changes to <
filename>
10139N/Axterm</
filename> have been been incorporated into <
command>&cmd;</
command>.
10139N/AThis includes emulation of the newer DEC VT220 escape sequences.</
para>
10139N/A<
refsect1 id="gnome-terminal-1-exam"><
title>&exam-tt;</
title>
10139N/A<
title>Running the `minicom' terminal emulator on the window</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; --command minicom</
userinput></
screen></
para>
10139N/A<
title>Monitoring the system</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; --command top</
userinput></
screen></
para>
10139N/A<
title>Starting two windows with different profiles</
title>
10139N/A<
para><
screen>example% <
userinput>&cmd; --window-with-profile=FirstProfile
10139N/A --tab-with-profile=SecondProfile --window-with-profile=SecondProfile</
userinput></
screen></
para>
10139N/A<
para>In this example, the first window will have two tabs (<
literal>FirstProfile
10139N/A</
literal> and <
literal>SecondProfile</
literal>) and the second window will
10139N/Ahave one tab (<
literal>SecondProfile</
literal>).</
para>
10139N/A<
refsect1 id="gnome-terminal-1-envr"><
title>&envr-tt;</
title>
10139N/A<
para>See <
citerefentry><
refentrytitle>environ</
refentrytitle><
manvolnum>
10139N/A5</
manvolnum></
citerefentry> for descriptions of the following environment
10139N/Avariables, set by <
command>&cmd;</
command>:</
para>
10139N/A<
varlistentry><
term>TERM</
term><
listitem><
para>This variable is set to <
literal>
10139N/Axterm</
literal> by default. Some implementations of curses, and applications
10139N/Abased on curses, may prefer the value to be <
literal>xterm-color</
literal>, <
literal>
10139N/Acolor-xterm</
literal>, or <
literal>xterm-debian</
literal> to support color.
10139N/AUsers might need to change this setting to one of these values to enable color
10139N/A<
varlistentry><
term>COLORTERM</
term><
listitem><
para>This variable is set to <
literal>
10139N/Axterm</
literal>. Various applications (especially the Slang-based applications)
10139N/Ause this setting to determine whether the terminal supports color.</
para>
10139N/A<
varlistentry><
term>WINDOWID</
term><
listitem><
para>This variable contains
10139N/Athe X11 Window identifier. This is sometimes used by applications to modify
10139N/Athe contents of this window or provide special effects.</
para>
10139N/A<
refsect1 id="gnome-terminal-1-exit"><
title>&exit-tt;</
title>
10139N/A<
para>The following exit values are returned:</
para>
10139N/A<
variablelist termlength="xtranarrow">
10139N/A<
varlistentry><
term><
returnvalue>0</
returnvalue></
term><
listitem><
para>Application
10139N/A<
varlistentry><
term><
returnvalue>>0</
returnvalue></
term><
listitem><
para>Application
10139N/A<
refsect1 id="gnome-terminal-1-file"><
title>&file-tt;</
title>
10139N/A<
para>The following files are used by this application:</
para>
10139N/A<
variablelist termlength="wide">
10139N/A<
varlistentry><
term><
filename>/
usr/
bin/&cmd;</
filename> </
term><
listitem>
10139N/A<
para>Executable for GNOME terminal emulator</
para>
10139N/A<
refsect1 id="gnome-terminal-1-attr"><
title>&attr-tt;</
title>
10139N/A<
para>See <
olink targetdocent="REFMAN5" localinfo="attributes-5"><
citerefentry>
10139N/A<
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry></
olink>
10139N/Afor descriptions of the following attributes:</
para>
10139N/A<
tgroup cols="2" colsep="1" rowsep="1"><
colspec colname="COLSPEC0" colwidth="1*">
10139N/A<
colspec colname="COLSPEC1" colwidth="1*">
10139N/A<
row><
entry align="center" valign="middle">ATTRIBUTE TYPE</
entry><
entry align="center" 10139N/Avalign="middle">ATTRIBUTE VALUE</
entry></
row>
10139N/A<
row><
entry colname="COLSPEC0"><
para>Interface stability</
para></
entry><
entry 10139N/Acolname="COLSPEC1"><
para>Volatile</
para></
entry></
row>
10139N/A<
refsect1 id="gnome-terminal-1-also"><
title>&also-tt;</
title>
10139N/A<!--Reference to another man page--> 10139N/A<!--Reference to a Help manual--> 11904N/A<
citerefentry><
refentrytitle>gnome-session</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11904N/A<
citerefentry><
refentrytitle>xterm</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11904N/A<
citerefentry><
refentrytitle>vte</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11904N/A<
citerefentry><
refentrytitle>libvte</
refentrytitle><
manvolnum>3</
manvolnum></
citerefentry>,
11904N/A<
citerefentry><
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>,
11904N/A<
citerefentry><
refentrytitle>environ</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>
11904N/A<
citerefentry><
refentrytitle>gnome-std-options</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>
10139N/A<
para>Latest version of the <
citetitle>GNOME Desktop User Guide</
citetitle>
10139N/A<
refsect1 id="gnome-terminal-1-note"><
title>¬e-tt;</
title>
10139N/A<
para>Written by Michael Zucchi, Miguel de Icaza, Erik Troan.</
para>
10139N/A<
para>Updated by Brian Cameron, Sun Microsystems Inc., 2003, 2004, 2006.</
para>