Manual Pages for UNIX Operating System command usage for man gnome-terminal

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]  [--maximize]  [--role=role]  [--show-menubar   | --
     hide-menubar]   [--startup-id=id]  [--title=title]   [--use-
     factory  | --disable-factory]  [--working-directory=dirname]
     [--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 supports  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, reduc-
     ing memory usage.  This can be disabled by  starting  gnome-
     terminal with the --disable-factory option.

OPTIONS
     The following options are supported:

     --active

         Set the last specified tab as the active one in its win-
         dow.



     -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 window.



     --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.




SunOS 5.11          Last change: 31 Aug 2004                    1






User Commands                                   gnome-terminal(1)



     --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.



     --maximize

         Set the last-specified window  into  maximized  mode;  a
         pplies  to  only  one  window; can be specified once for
         each window 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 iden-
         tify 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 ses-
         sion 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



SunOS 5.11          Last change: 31 Aug 2004                    2






User Commands                                   gnome-terminal(1)



         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 mul-
         tiple 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-profile
         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 pro-
         file.  More than one of these options can be provided.



     --window-with-profile=profilename

         Creates a  GNOME  terminal  and  a  tab  that  uses  the



SunOS 5.11          Last change: 31 Aug 2004                    3






User Commands                                   gnome-terminal(1)



         specified  profile.  This  may  be  used with the --tab-
         with-profile option to create additional 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 infor-
         mation.



EXTENDED DESCRIPTION
     gnome-terminal is designed to emulate the xterm program pro-
     vided 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





SunOS 5.11          Last change: 31 Aug 2004                    4






User Commands                                   gnome-terminal(1)



     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 (First-
     Profile  and  SecondProfile) and the second window will have
     one tab (SecondProfile).

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. Vari-
                             ous   applications  (especially  the
                             Slang-based applications)  use  this
                             setting  to  determine  whether  the
                             terminal supports color.



     WINDOWID                This variable contains the X11  Win-
                             dow  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






SunOS 5.11          Last change: 31 Aug 2004                    5






User Commands                                   gnome-terminal(1)



FILES
     The following files are used by this application:

     /usr/bin/gnome-terminal         Executable for GNOME  termi-
                                     nal emulator



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | terminal/gnome-terminal     |
    |_____________________________|_____________________________|
    | Interface stability         | Volatile                    |
    |_____________________________|_____________________________|


SEE ALSO
     gnome-session(1),  xterm(1),   vte(1),   libvte(3),   attri-
     butes(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          Last change: 31 Aug 2004                    6