


uit(1)                                                     uit(1)


NNAAMMEE
       uit - UNIX Interactive Tools version 4.3.1

SSYYNNTTAAXX
       _u_i_t
       _u_i_t_p_s [_p_s(1) like parameters]
       _u_i_t_v_i_e_w filename


NNOOTTEE
       The  main  configuration  file of the _U_I_T _4_._3_._1 package is
       ..uuiittrrcc..TTEERRMM where TTEERRMM is the  value  of  the  environment
       variable  'TTEERRMM'  e.g  for  Linux console your environment
       contains something like 'TTEERRMM==ccoonnssoollee' so  the  configura-
       tion  file  name  is ..uuiittrrcc..ccoonnssoollee.  You can (and should)
       have a configuration file for each terminal type you  use.


DDEESSCCRRIIPPTTIIOONN
       _u_i_t  is  a  ffiillee ssyysstteemm bbrroowwsseerr with some shell facilities
       which was designed to make your work much easier and  much
       efficient.

       _u_i_t_p_s  is  an  interactive process viewer/killer. It calls
       internally the _p_s(1) utility  so  that's  the  reason  why
       _u_i_t_p_s  parameters are in fact _p_s(1) ones. Running _u_i_t_p_s it
       is self explanatory. Use  the  arrows,  PageUp,  PageDown,
       Home,  End,  ^Y,  ^B,  ^Ku, ^Kv to move in the list, ^R to
       refresh it and F10 or ^C to leave. You  can  change  these
       keys, just read the sections [[UUIITTPPSS--SSeettuupp]],, [[UUIITTPPSS--CCoolloorr]],,
       [[UUIITTPPSS--MMoonnoocchhrroommee]] aanndd [[UUIITTPPSS--KKeeyyss]] in  the  configuration
       file ..uuiittrrcc..TTEERRMM.  See also CCOONNFFIIGGUURRAATTIIOONN FFIILLEESS.

       _u_i_t_v_i_e_w  is an hex/ascii file viewer. Too simple to need a
       separate manual page. Use the  arrows,  PageUp,  PageDown,
       Home,  End,  ^Y,  ^B,  ^Ku, ^Kv to move in the file, ^R to
       refresh the screen and F10 or ^C to leave. You can  change
       those   keys,  just  read  the  sections  [[UUIITTVVIIEEWW--SSeettuupp]],,
       [[UUIITTVVIIEEWW--CCoolloorr]],, [[UUIITTVVIIEEWW--MMoonnoocchhrroommee]]  aanndd  [[UUIITTVVIIEEWW--KKeeyyss]]
       in  the configuration file ..uuiittrrcc..TTEERRMM.  See also CCOONNFFIIGGUU--
       RRAATTIIOONN FFIILLEESS.


FFIILLEE--SSYYSSTTEEMM BBRROOWWSSEERR
       _u_i_t is made of two panels. The left one and the right one.
       Each  one contains a file system directory. You can browse
       the directory tree with the usual cursor keys and pressing
       EENNTTEERR  when  you  want to enter or leave a directory.  You
       may change the panels by pressing TTAABB.  See also  BBUUIILLTT--IINN
       CCOOMMMMAANNDDSS.


CCOOMMMMAANNDD LLIINNEE
       Under  the  two  panels there is a shell like command line



Release 4.3.1              August 1994                          1





uit(1)                                                     uit(1)


       which you can use to type normal shell commands. The  com-
       mand  line  supports up to 256 characters and 512 commands
       in the history list. UIT uses the GNU history library  for
       that.  See also BBUUIILLTT--IINN CCOOMMMMAANNDDSS.


WWAARRNNIINNGGSS AANNDD EERRRROORRSS RREEPPOORRTTIINNGG
       Under  the command line there is a status bar. You can see
       there the status of the currently  executed  command,  the
       warnings and errors and you will be prompted if a decision
       has to be taken.


CCOONNFFIIGGUURRAATTIIOONN FFIILLEESS
       There is one  configuration  file  per  terminal  type  in
       _u_i_t/_u_i_t_p_s/_u_i_t_v_i_e_w.   The  configuration file(s) resides in
       the user's home directory or (the default versions) in the
       directory  $(prefix)/lib  (usually  /usr/local/lib).   The
       generic name is ..uuiittrrcc..TTEERRMM.  UUIITT 44..33..11 allows each termi-
       nal  type  to have its own configuration file (TTEERRMM is the
       value of the 'TTEERRMM' environment variable (e.g vt102).  For
       the    Linux    console    the   configuration   file   is
       ..uuiittrrcc..ccoonnssoollee).

       If you have compiled the _U_I_T package with UUSSEE__TTEERRMMCCAAPP  and
       your  system  has  a huge termcap database (/etc/termcap),
       you can copy the termcap definition(s) of your terminal(s)
       in  a  file  ($HOME/.termcap  e.g.).  After that, set your
       TTEERRMMCCAAPP environment variable to point to  it.  You  should
       add something like this to your ..pprrooffiillee:

       TTEERRMMCCAAPP==//hhoommee//mmiikkee//..tteerrmmccaapp

       _u_i_t/_u_i_t_p_s/_u_i_t_v_i_e_w can run without such a file, but on sys-
       tems with huge termcap databases, copying the  definitions
       of the most used terminals in a local ..tteerrmmccaapp will result
       in _u_i_t/_u_i_t_p_s/_u_i_t_v_i_e_w starting  faster.   _u_i_t/_u_i_t_p_s/_u_i_t_v_i_e_w
       doesn't  use  termcap key definitions. You must define the
       keys you want directly in the ..uuiitt..TTEERRMM file  in  [[UUIITTxxxxxx--
       KKeeyyss]] sections.

       If you have compiled the _U_I_T package with UUSSEE__TTEERRMMIINNFFOO, or
       on your system the termcap database is emulated using  the
       terminfo  library (like in the HP-UX system), don't bother
       about speed.

       See also the sections [[UUIITTxxxxxx--KKeeyyss]].

       The configuration file ..uuiittrrcc..TTEERRMM is the file searched by
       _u_i_t/_u_i_t_p_s/_u_i_t_v_i_e_w  each time they are started, in order to
       configure themselves.  ..uuiittrrcc..TTEERRMM it is first searched in
       the  home  directory  then, if not found, in the directory
       $(prefix)/lib (usually /usr/local/lib). The  configuration
       file  is  structured  on sections, each section containing



Release 4.3.1              August 1994                          2





uit(1)                                                     uit(1)


       variables in the following format:

            vvaarriiaabbllee__nnaammee = ffiirrsstt__ffiieelldd;sseeccoonndd__ffiieelldd; ......

       After the variable_name at  least  one  space  or  tab  is
       required.   All  characters after a '##' are ignored and if
       you comment a section name, the whole section is  ignored.

       The  default  configuration file ..uuiittrrcc..TTEERRMM supports most
       of the usual commands. To find out more about them  please
       read  it.   _u_i_t allows you to change both the utility used
       to perform a particular operation (using compress  instead
       of  gzip  :-)  )  and the key associated with it. There is
       also possible to remove/add new commands.

       The configuration file contains the following sections:

       11.. [[SSeettuupp]]

       In this section the variables have only one field.

       a.  TTeemmppDDiirreeccttoorryy
        - this variable specifies the location of  the  temporary
       files created by _u_i_t.

       b.  AAnnssiiCCoolloorrSSeeqquueenncceess
        -  this variable should be set to OONN if the terminal sup-
       ports standard AANNSSII color sequences. Otherwise  it  should
       be  OOFFFF.  If AAnnssiiCCoolloorrSSeeqquueenncceess is OONN, [[UUIITTxxxxxx--CCoolloorr]] sec-
       tions will be used in the configuration files ..uuiittrrcc..TTEERRMM.
       Otherwise,   _u_i_t/_u_i_t_p_s/_u_i_t_v_i_e_w   will   use  the  [[UUIITTxxxxxx--
       MMoonnoocchhrroommee]] sections.

       22.. [[UUIITT--SSeettuupp]]

       In this section the variables have only one field.

       a.  SSttaarrttuuppFFiilleeDDiissppllaayyMMooddee
        - this variable specifies the file  specific  information
       displayed  at startup. It can be any of OOwwnneerrGGrroouupp , DDaattee--
       TTiimmee , SSiizzee , MMooddee or FFuullllNNaammee.
        - this value initially affects both panels but it can  be
       changed separately afterwards.

       b.  SSttaarrttuuppFFiilleeSSoorrttMMeetthhoodd

        - this variable specifies the startup sort method. It can
       be any of NNaammee , EExxtteennssiioonn , SSiizzee , DDaattee , MMooddee ,  OOwwnneerrIIdd
       , GGrroouuppIIdd , OOwwnneerrNNaammee or GGrroouuppNNaammee.
        -  this value initially affects both panels but it can be
       changed separately afterwards.

       c.  SSttaarrttuuppLLeeffttPPaanneellPPaatthh
       d.  SSttaarrttuuppRRiigghhttPPaanneellPPaatthh



Release 4.3.1              August 1994                          3





uit(1)                                                     uit(1)


        - those variables specifies the  startup  path  for  each
       panel.

       e.  HHiissttoorryyFFiillee
        -  this  variable  specifies  the  history file name. The
       default value is ~~//..uuiitthhiissttoorryy.

       f.  NNoorrmmaallMMooddeeHHeellpp
       g.  CCoommmmaannddLLiinneeMMooddeeHHeellpp
        - those variables describe the status  bar  contents  for
       each  _u_i_t mode when no errors occurred (uit is idle).  _u_i_t
       can display on the status bar a help  string  and/or  some
       system  information  (system  type, hostname, machine type
       and the current date) using escape characters (s, h, m  or
       d preceded by backslash):
            ss    ->      the system type
            hh    ->      the host name
            mm    ->      the machine type
            dd    ->      the current date
            See also <<SShhoowwTTttyy>>.

            h.  IInnffooDDiissppllaayy
             -  if  this variable is OFF, auxiliary file informa-
            tions are not displayed.  This can be useful  if  you
            are using a very slow terminal.

            i.  FFrraammeeDDiissppllaayy
             - if this variable is OFF, the uit frame is not dis-
            played. This can be useful if you are  using  a  very
            slow terminal.

            j.  LLeeaaddiinnggDDoottMMaattcchh

             -  if  this variable is OOFFFF, when matching files for
            <<FFiilleePPaatttteerrnnSSeelleecctt>> / <<FFiilleePPaatttteerrnnUUnnsseelleecctt>> then  the
            leading ''..''  in the file name is matched only explic-
            itly.


            33.. [[UUIITTPPSS--SSeettuupp]]

            In this section the variables have only one field.

            a.  UUiittPPssMMooddeeHHeellpp
             - this variable describe the _u_i_t_p_s status  bar  con-
            tents.

            44.. [[UUIITTVVIIEEWW--SSeettuupp]]

            In this section the variables have only one field.

            a.  UUiittVViieewwMMooddeeHHeellpp
             - this variable describe the _u_i_t_v_i_e_w status bar con-
            tents.



Release 4.3.1              August 1994                          4





uit(1)                                                     uit(1)


            55.. [[UUIITTxxxxxx--CCoolloorr]] // [[UUIITTxxxxxx--MMoonnoocchhrroommee]]

            In this sections the variables have only one field.

            These sections permits you to customize the colors of
            _u_i_t, _u_i_t_p_s and _u_i_t_v_i_e_w.  Reading the ..uuiittrrcc..TTEERRMM con-
            figuration file should be self explanatory.  See also
            the [[SSeettuupp]] section.

            66.. [[UUIITT--KKeeyyss]]

            This  section  describes the actions _u_i_t takes when a
            specified key is pressed. In this section a  variable
            can  have up to 6 fields separated by ';'.  Each line
            in this section looks like:

            kkeeyy__sseeqquueennccee                  =                  ccoomm--
            mmaanndd__nnaammee;ffoorrmmaatttteedd__ccoommmmaanndd;nneeww__ddiirr;
                           ssaavvee__ssccrreeeenn;ppaauussee;hhiiddee

            WWAARRNNIINNGG  :  you  can't  continue  the variable fields
            description on the next line.


            a.  kkeeyy__sseeqquueennccee
             - kkeeyy__sseeqquueennccee is the key sequence  associated  with
            the  given command. You can use any key sequence wich
            doesn't start with an ascii character (0x20 to 0x7e).
            You can specify the EESSCC character as ^^[[ , the ^^ char-
            acter as ^^^^ and ssppaaccee as ^^@@ .  Ascii  characters  are
            used by the command line.

            b.  ccoommmmaanndd__nnaammee
             - ccoommmmaanndd__nnaammee is a command generic name. Even if it
            is not always used, the ccoommmmaanndd__nnaammee must be  present
            (if  a  command is associated with kkeeyy__sseeqquueennccee).  If
            it is not, no action  will  be  taken  when  pressing
            kkeeyy__sseeqquueennccee..  There are two types of commands in _u_i_t
            :  bbuuiilltt--iinn  commands  and  uusseerr  ddeeffiinneedd   commands.
            BBuuiilltt--iinn  commands  are specified between <> (<<CCooppyy>>,
            <<RReennaammeeMMoovvee>>, <<MMkkDDiirr>> etc) and  if  the  ccoommmmaanndd__nnaammee
            section  contains  a  built-in command specification,
            the other fields are ignored.


            The BBUUIILLTT--IINN CCOOMMMMAANNDDSS are:

            <<CCooppyy>>
             - copies files from one panel to another.

            <<RReennaammeeMMoovvee>>
             - moves files from one panel to another.

            <<MMkkDDiirr>>



Release 4.3.1              August 1994                          5





uit(1)                                                     uit(1)


             - makes directories.

            <<DDeelleettee>>
             - deletes files and empty directories.

            <<EExxiitt>>
             - exits _u_i_t.

            <<HHiissttoorryyBBaacckk>>
             - copies to the command line the previous command in
            the history list.

            <<SShhoowwTTttyy>>
             -  switches between the two _u_i_t modes (starting with
            Linux 0.99.12 this option is completely used only  if
            you  are  super  user because normal users can't do a
            screen dump).

            <<RReeffrreesshh>>
             - refreshes the contents of the current panel.

            <<GGoottooRRoooott>>
             - changes the current directory to root.

            <<SSwwiittcchhPPaanneellss>>
             - switches the left panel with the right one.

            <<HHiissttoorryyNNeexxtt>>
             - copies the next command in the history list to the
            command line.

            <<FFiilleeDDiissppllaayyNNeexxttMMooddee>>
             - switches to the next file display mode.

            <<FFiilleeDDiissppllaayyOOwwnneerrGGrroouupp>>
             - displays the file owner & group.

            <<FFiilleeDDiissppllaayyDDaatteeTTiimmee>>
             - displays the file date & time.

            <<FFiilleeDDiissppllaayySSiizzee>>
             - displays the file size.

            <<FFiilleeDDiissppllaayyMMooddee>>
             - displays the file mode.

            <<FFiilleeDDiissppllaayyFFuullllNNaammee>>
             - displays the full file name (if possible).

            <<FFiilleeSSoorrttNNeexxttMMeetthhoodd>>
             - switches to the next sort method.

            <<FFiilleeSSoorrttBByyNNaammee>>
             - sorts the files by extension.



Release 4.3.1              August 1994                          6





uit(1)                                                     uit(1)


            <<FFiilleeSSoorrttBByyEExxtteennssiioonn>>
             - sorts the files by name.

            <<FFiilleeSSoorrttBByySSiizzee>>
             - sorts the files by size.

            <<FFiilleeSSoorrttBByyDDaattee>>
             - sorts the files by date.

            <<FFiilleeSSoorrttBByyMMooddee>>
             - sorts the files by mode.

            <<FFiilleeSSoorrttBByyOOwwnneerrIIdd>>
             - sorts the files by owner id.

            <<FFiilleeSSoorrttBByyGGrroouuppIIdd>>
             - sorts the files by group id.

            <<FFiilleeSSoorrttBByyOOwwnneerrNNaammee>>
             - sorts the files by owner name.

            <<FFiilleeSSoorrttBByyGGrroouuppNNaammee>>
             - sorts the files by group name.

            <<DDeelleetteeCCmmddLLnn>>
             - deletes the command line contents.

            <<FFiilleeSSeelleecctt>>
             -  selects/unselects  files.  All  the  files can be
            selected by pressing '++' (and ENTER) or unselected by
            pressing '--'.  By pressing '**' selected files becomes
            unselected and unselected files becomes selected.

            <<CCooppyyFFiilleeTTooCCmmddLLnn>>
             - copies to the command line the current file name .

            <<HHoommee>>
             -  puts  the cursor onto the first entry in the cur-
            rent directory list.

            <<EEnndd>>
             - puts the cursor onto the last entry in the current
            directory list.

            <<PPaaggeeUUpp>>
             -  puts the cursor up one page in the current direc-
            tory file list.

            <<PPaaggeeDDoowwnn>>
             - puts the cursor  down  one  page  in  the  current
            directory file list.

            <<CCuurrssoorrLLeefftt>>
             - acts like <<PPaaggeeUUpp>>.



Release 4.3.1              August 1994                          7





uit(1)                                                     uit(1)


            <<CCuurrssoorrRRiigghhtt>>
             - acts like <<PPaaggeeDDoowwnn>>.

            <<CCuurrssoorrUUpp>>
             - puts the cursor up one entry in the current direc-
            tory file list.

            <<CCuurrssoorrDDoowwnn>>
             - puts the cursor down  one  entry  in  the  current
            directory file list.

            <<CChhaannggeePPaanneell>>
             - puts the cursor in the other panel.

            <<CChhaannggeeDDiirr>>
             -  changes the current directory to a user specified
            directory.

            <<HHaarrddRReeffrreesshh>>
             - forces a screen refresh.

            <<FFiilleePPaatttteerrnnSSeelleecctt>>
             - selects files matching a given pattern.

            <<FFiilleePPaatttteerrnnUUnnsseelleecctt>>
             - unselects files matching a given pattern.

            <<DDeelleetteeCCmmddLLnnWWoorrdd>>
             - deletes the last command line word.

            <<CCoonnffoorrmmCCuurrrreennttDDiirr>>
             - the other panel current directory will become  the
            current directory of the current panel.

            <<CCoonnffoorrmmOOtthheerrDDiirr>>
             -  the  current  directory of the current panel will
            become the current directory of the other panel.

            <<CCooppyyPPaatthhTTooCCmmddLLnn>>
             - copy the other panel path to the command line.

            <<CCooppyySSeelleecctteeddFFiilleessTTooCCmmddLLnn>>
             - copy all the current panel selected file names  to
            the command line.


            c.  ffoorrmmaatttteedd__ccoommmmaanndd
             -  ffoorrmmaatttteedd__ccoommmmaanndd  is  a  shell command which can
            contain some  scanf  like  format  specifiers.   With
            their  help  you  can get the current directory entry
            name (the directory entry under the  cursor),  owner,
            group and mode. These are the available ffoorrmmaatt ssppeeccii--
            ffiieerrss:




Release 4.3.1              August 1994                          8





uit(1)                                                     uit(1)


             - %%ss{{qquueessttiioonn,,ddeeffaauulltt__aannsswweerr}}
            When _u_i_t encounters a  %%ss  in  the  formatted_command
            asks  the  user the question 'question' whose default
            answer is 'default_answer' and replaces the %%ss{{  ,,  }}
            with   the   user   answer.   Both   'question'   and
            'default_answer' can contain any other format  speci-
            fiers except %%ss.

            WWAARRNNIINNGG : no spaces between %%ss and '{{'.

             - %%ff
            _u_i_t  will replace %%ff with the current directory entry
            name only if it is a file (not a directory).

             - %%dd
            _u_i_t will replace %%dd with the current directory  entry
            name only if it is a directory (not a file).

             - %%ll
            _u_i_t  will replace %%ll with the current directory entry
            name only if it is a symbolic link.

             - %%tt
            _u_i_t will replace %%tt with the current directory  entry
            name only if it is a named pipe.

             - %%zz
            _u_i_t  will replace %%zz with the current directory entry
            name only if it is a socket.

             - %%aa
            _u_i_t will always replace %%aa with the current directory
            entry name.

             - %%mm
            _u_i_t  will  always replace %%mm in the formatted_command
            with the current file mode.

             - %%gg
            _u_i_t will always replace %%gg in  the  formatted_command
            with the current file group.

             - %%oo
            _u_i_t  will  always replace %%oo in the formatted_command
            with the current file owner.

             - %%pp
            _u_i_t will always replace %%pp in  the  formatted_command
            with the current panel path.

             - %%bb
            _u_i_t  will  always replace %%bb in the formatted_command
            with the current panel directory name.




Release 4.3.1              August 1994                          9





uit(1)                                                     uit(1)


             - %%ii
            _u_i_t will always replace %%ii in  the  formatted_command
            with all the current panel selected file names.

            Using uuppppeerrccaassee ffoorrmmaatt ssppeecciiffiieerrss you will be able to
            access the  other  panel  path,  file  and  directory
            names.

            d.  nneeww__ddiirr
             -  if the ffoorrmmaatttteedd__ccoommmmaanndd successfully exits (exit
            code = 0) and this field is present then nneeww__ddiirr will
            become  the current panel directory.  The character ~~
            used at the begining of the nneeww__ddiirr field is replaced
            by the user's home directory.

            e.  ssaavvee__ssccrreeeenn
             -  this  field  is an character (usually 'y' or 'n')
            who tells _u_i_t to save ('y') or not to save ('n')  the
            terminal   screen   after   executing   the   ffoorrmmaatt--
            tteedd__ccoommmmaanndd..  Saving  the  screen  is  not  necessary
            while  editing or viewing a file because the informa-
            tion left after the editor or the viewer exits is not
            important.  Saving  the screen means that that screen
            will be restored before the  execution  of  the  next
            command.  This  field  is  used only if you are super
            user under Linux and you are  working  on  a  virtual
            console.  By default this field is 'y'.

            f.  ppaauussee
             -  for  some  commands  you  may  wish to read their
            results     before repainting  the  panels.  If  this
            field  is  present  _u_i_t  will  wait  for  a key to be
            pressed before restoring the panels.  By default this
            field is 'n'.

            g.  hhiiddee
             - there are some commands that aren't displaying any
            useful information  if  successfully  complete  their
            execution:  mount,  chmod, chown, chgrp, sync ... and
            if an error occurs then a line or two are  sended  to
            stderr.   If  this  option  is  'y',  the  stdout and
            stderr will be redirected to some  files  (ssttddoouutt..ppiidd
            and  ssttddeerrrr..ppiidd  ,  where ppiidd is _u_i_t _p_i_d) and only if
            the command exit code is not 0, the  ssttddeerrrr..ppiidd  file
            will be displayed, line by line, onto the status bar.
            This way the panels will  not  be  deleted  and  then
            repainted  and  the  command  appears to be built-in.
            ssttddoouutt..ppiidd and ssttddeerrrr..ppiidd are created in the  TTeemmppDDii--
            rreeccttoorryy  specified in the [[SSeettuupp]] section. By default
            this field is 'n'.

            The default configuration file $$HHOOMMEE//..uuiittrrcc..TTEERRMM sup-
            ports  most  of  the usual commands. To find out more
            about them please read it.  _u_i_t allows you to  change



Release 4.3.1              August 1994                         10





uit(1)                                                     uit(1)


            both  the utility used to perform a particular opera-
            tion (using compress instead of gzip :-)  )  and  the
            key  associated  with  it.  There is also possible to
            rreemmoovvee/aadddd new commands.

            77.. [[UUIITTPPSS--KKeeyyss]]

            This section describes the actions _u_i_t_p_s takes when a
            specified  key is pressed. In this sections the vari-
            ables have only one field. Only  built-in  operations
            are  available  in  _u_i_t_p_s.  Each line in this section
            looks like:

            kkeeyy__sseeqquueennccee = bbuuiilltt__iinn__ccoommmmaanndd__nnaammee


            a.  kkeeyy__sseeqquueennccee
             - kkeeyy__sseeqquueennccee is the key sequence  associated  with
            the  given command. You can use any key sequence wich
            doesn't start with an ascii character (0x20 to 0x7e).
            You can specify the EESSCC character as ^^[[ , the ^^ char-
            acter as ^^^^ and ssppaaccee as ^^@@ .

            b.  bbuuiilltt__iinn__ccoommmmaanndd__nnaammee
             - bbuuiilltt__iinn__ccoommmmaanndd__nnaammee is the name of the  built-in
            operation  to  run  when kkeeyy__sseeqquueennccee is pressed. The
            built-in operations are:

            - <<CCuurrssoorrUUpp>> - moves to the previous process  in  the
            processes list
            -  <<CCuurrssoorrDDoowwnn>>  -  moves  to the next process in the
            processes list
            - <<PPaaggeeUUpp>> - moves one page up in the processes list
            - <<PPaaggeeDDoowwnn>> - moves one page down in  the  processes
            list
            -  <<HHoommee>>  -  moves  to the first process in the pro-
            cesses list
            - <<EEnndd>> - moves to the last process in the  processes
            list
            -  <<NNeexxttSSiiggnnaall>> - sets the next signal in the signals
            list as the current signal
            - <<SSIIGGHHUUPP>>
            - <<SSIIGGIINNTT>>
            - <<SSIIGGQQUUIITT>>
            - <<SSIIGGIILLLL>>
            - <<SSIIGGFFPPEE>>
            - <<SSIIGGKKIILLLL>>
            - <<SSIIGGUUSSRR11>>
            - <<SSIIGGSSEEGGVV>>
            - <<SSIIGGUUSSRR22>>
            - <<SSIIGGPPIIPPEE>>
            - <<SSIIGGAALLRRMM>>
            - <<SSIIGGTTEERRMM>>
            - <<SSIIGGCCHHLLDD>>



Release 4.3.1              August 1994                         11





uit(1)                                                     uit(1)


            - <<SSIIGGCCOONNTT>> - sets the SIG... signal as  the  current
            signal
            -  <<KKiillllPPrroocceessss>>  -  sends  the current signal to the
            current process
            - <<RReeffrreesshh>> -  refresh  the  processes  list  by  re-
            calling ppss(1)
            - <<HHaarrddRReeffrreesshh>> - force the screen refresh the screen
            by re-calling ppss(1)  and  invalidating  the  terminal
            cache.
            - <<EExxiitt>> - exits

            88.. [[UUIITTVVIIEEWW--KKeeyyss]]

            This section describes the actions _u_i_t_v_i_e_w takes when
            a specified key is  pressed.  In  this  sections  the
            variables  have  only one field. Only built-in opera-
            tions are available in _u_i_t_v_i_e_w.  Each  line  in  this
            section looks like:

            kkeeyy__sseeqquueennccee = bbuuiilltt__iinn__ccoommmmaanndd__nnaammee


            a.  kkeeyy__sseeqquueennccee
             -  kkeeyy__sseeqquueennccee  is the key sequence associated with
            the given command. You can use any key sequence  wich
            doesn't start with an ascii character (0x20 to 0x7e).
            You can specify the EESSCC character as ^^[[ , the ^^ char-
            acter as ^^^^ and ssppaaccee as ^^@@ .


            b.  bbuuiilltt__iinn__ccoommmmaanndd__nnaammee
             -  bbuuiilltt__iinn__ccoommmmaanndd__nnaammee is the name of the built-in
            operation to run when kkeeyy__sseeqquueennccee  is  pressed.  The
            built-in operations are:

            -  <<CCuurrssoorrUUpp>> - moves to the previous line (16 bytes)
            in the file
            - <<CCuurrssoorrDDoowwnn>> - moves to the next line (16 bytes) in
            the file
            -  <<PPaaggeeUUpp>>  - moves one page up (0x100 bytes) in the
            file
            - <<PPaaggeeDDoowwnn>> - moves one page down (0x100  bytes)  in
            the file
            - <<HHoommee>> - moves to the beginning of the file
            - <<EEnndd>> - moves to the end of the file
            -  <<RReeffrreesshh>>  -  refresh the screen by re-reading the
            file
            - <<HHaarrddRReeffrreesshh>> - force the screen refresh the screen
            by  re-reading the file and invalidating the terminal
            cache.
            - <<EExxiitt>> - exits






Release 4.3.1              August 1994                         12





uit(1)                                                     uit(1)


CCAANNCCEELLIINNGG OOPPEERRAATTIIOONNSS
       Built-in cyclic operations can be stopped by pressing  ^^CC.
       _u_i_t can be suspended by pressing ^^ZZ.



LLIIMMIITTAATTIIOONNSS
       11..   Background  execution  is  not  fully supported. That
       means you may specify an && terminated command line in  the
       configuration  file  but the result of the background exe-
       cuted command (stdout and stderr redirection, as explained
       before)  will  be  overwritten by the result of newer com-
       mands and, if an error occurs, you will not see it.

       22..  No command line editing is provided. You can only mod-
       ify  the  contents  of  the  command line by appending new
       characters, deleting them with backspace or ^^HH , or delet-
       ing  the  last  word with the key sequence associated with
       <<DDeelleetteeCCmmddLLnnWWoorrdd>>.  You can also insert the  current  file
       name  into the command line using the key sequence associ-
       ated with <<CCooppyyFFiilleeTTooCCmmddLLnn>> and the other panel path using
       the key sequence associated with <<CCooppyyPPaatthhTTooCCmmddLLnn>>.

       33..   When  _u_i_t is compiled for LLiinnuuxx, the default built-in
       color descriptions are for color monitors,  so  you  can't
       (decently)   run   _u_i_t   on  a  b/w  monitor  without  the
       ..uuiittrrcc..TTEERRMM file correctly configured.  ..uuiittrrcc..TTEERRMM should
       be configured with CCoolloorrMMoonniittoorr == OOFFFF.  If you are working
       on a serial b/w tty, LLiinnuuxxCCoonnssoollee should be OOFFFF too.

       44..  Only PPOOSSIIXX terminals are supported.

       55..  JJoobb support is implemented only in _u_i_t.

       66..  Due to the fact that the ';;' character is  used  as  a
       field  separator  in  the  configuration  files, you can't
       write something like that in the ..uuiittrrcc..TTEERRMM files:

       ^AAA  =  SHOW-USERS-AND-GROUPS;  more  /etc/passwd;   more
       /etc/group

       because  'more  /etc/group' will be considered as a direc-
       tory to switch to.  You must write a small script instead:

       #!/bin/sh
       more /etc/passwd; more /etc/group

       Supposing  the  script name is 'sshhooww__uugg' , the ..uuiittrrcc..TTEERRMM
       line will be like that:

       ^AAA = SHOW-USERS-AND-GROUPS; show_ug






Release 4.3.1              August 1994                         13





uit(1)                                                     uit(1)


BBUUGGSS
       None so far. :-)

       Please send bug reports  to  _t_u_d_o_r_@_u_l_i_s_e_._c_s_._p_u_b_._r_o  or  to
       _t_u_d_o_r_@_h_a_b_a_r_n_a_m_._c_s_._p_u_b_._r_o.


SSEEEE AALLSSOO
       termcap(5)  terminfo(5)  sh(1)  ps(1)  mount(8)  umount(8)
       uitaction(1) uitmount(1) uitmatch(1) uitcmp(1) uitkeys(1)


FFIILLEESS
       /usr/local/bin/uit
       /usr/local/bin/uitps
       /usr/local/bin/uitview
       /usr/local/man/man1/uit.1
       /usr/local/man/man1/uitps.1
       /usr/local/man/man1/uitview.1
       /usr/local/info/uit.info
       /usr/local/lib/.uitrc.console
       /usr/local/lib/.uitrc.xterm
       /usr/local/lib/.uitrc.vt100
       /usr/local/lib/.uitrc.vt102
       $HOME/.uitrc.console
       $HOME/.uitrc.xterm
       $HOME/.uitrc.vt100
       $HOME/.uitrc.vt102


AAUUTTHHOORRSS
       _T_u_d_o_r _H_u_l_u_b_e_i
       - tudor@ulise.cs.pub.ro, tudor@habarnam.cs.pub.ro
       _A_n_d_r_e_i _P_i_t_i_s
       - pink@ulise.cs.pub.ro, pink@habarnam.cs.pub.ro
       PPoolliitteecchhnniicc UUnniivveerrssiittyy ooff BBuucchhaarreesstt
       RRoommaanniiaa




















Release 4.3.1              August 1994                         14


