


uit(1)                                                     uit(1)


NNAAMMEE
       uit - UNIX Interactive Tools version 4.1c

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


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. No more manual is
       provided for _u_i_t_p_s because running it is self explanatory.
       Use  the arrows, PageUp, PageDown, Home, End, ^y, ^b, ^ku,
       ^kv, + and - to move in the list, r to refresh it and  F10
       or ^C to leave.

       _u_i_t_v_i_e_w  is  a hex/ascii file viewer. Too simple to need a
       manual page. Use the arrows, PageUp, PageDown, Home,  End,
       ^y,  ^b,  ^ku,  ^kv,  +  and  -  to move in the file, r to
       refresh the screen and F10 or ^C to leave.

       _u_i_t_c_m_p is a file compare utility. It  outputs  to  ssttddeerrrr,
       _u_i_t  catching  its  error  messages  this way.  _u_i_t_c_m_p was
       designed to be used  in  $$HHOOMMEE//..uuiittrrcc  (uuiitt  configuration
       file) and should not be used as a stand alone program.


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
       which  you can use to type normal shell commands. The com-
       mand line supports up to 256 characters and 32 commands in
       the history list.  See also BBUUIILLTT--IINN CCOOMMMMAANNDDSS.


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



Release 4.1c                April 1994                          1





uit(1)                                                     uit(1)


       has to be taken.


CCOONNFFIIGGUURRAATTIIOONN FFIILLEESS
       There are two configuration files in  _u_i_t/_u_i_t_p_s  :  ..uuiittrrcc
       and ..uuiitttteerrmmccaapp.  Their place is in the user's HHOOMMEE direc-
       tory, but _u_i_t (and _u_i_t_p_s) can work without them (except if
       you are connected to a Linux system with a serial b/w tty;
       see BBUUGGSS below). I don't  recommend  working  without  the
       ..uuiittrrcc  configuration  file  since it contains very useful
       key definitions.

       The ..uuiitttteerrmmccaapp is a llooccaall tteerrmmccaapp ddaattaabbaassee, which  allows
       _u_i_t/_u_i_t_p_s to find very fast the termcap description of the
       terminal specified in the TTEERRMM environment  variable.  You
       can  copy  your terminal description from //eettcc//tteerrmmccaapp and
       put it in the ..uuiitttteerrmmccaapp because //eettcc//tteerrmmccaapp is  ussualy
       a very large and hard to search file.

       _u_i_t  uses  ..uuiitttteerrmmccaapp  to  find  a  terminal  description
       **BBEEFFOORREE** trying to read //eettcc//tteerrmmccaapp.  If  ..uuiitttteerrmmccaapp  is
       found  in  the user's HHOOMMEE directory, //eettcc//tteerrmmccaapp will be
       ignored. The main advantage of  the  ..uuiitttteerrmmccaapp  file  is
       that  it  allows faster access and can be modified without
       special permission. You can use only  one  of  ..uuiitttteerrmmccaapp
       and  //eettcc//tteerrmmccaapp  at  a time. Take care: if you are using
       ..uuiitttteerrmmccaapp and your terminal description can't  be  found
       there,  _u_i_t  will  fail  because the //eettcc//tteerrmmccaapp database
       won't be searched. See also BBUUGGSS.

       The configuration file ..uuiittrrcc is  the  file  _u_i_t  searches
       each  time it is started, trying to configure itself read-
       ing it.  _u_i_t searches it in the  home  directory  and  the
       current  directory.  If this file can't be found, _u_i_t will
       use the defaults.  The configuration file is structured on
       sections, each section containing variables in the follow-
       ing format:

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

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

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



Release 4.1c                April 1994                          2





uit(1)                                                     uit(1)


       b.  LLiinnuuxxCCoonnssoollee
        - this variable should be set to OONN on LLiinnuuxx  systems  if
       you  are  working on a LLiinnuuxx vviirrttuuaall ttttyy.  If you are con-
       nected to a LLiinnuuxx system with a serial b/w tty, you should
       set  this  to OOFFFF.  LLiinnuuxxCCoonnssoollee is meaningless if _u_i_t was
       compiled without 'HHAAVVEE__LLIINNUUXX'.

       c.  CCoolloorrMMoonniittoorr
        - this variable should be set to OONN on LLiinnuuxx  systems  if
       you  are  working  on  a  LLiinnuuxx vviirrttuuaall ttttyy and you have a
       ccoolloorr mmoonniittoorr.  If your monitor is mmoonnoocchhrroommee, you  should
       set  this  to OOFFFF.  CCoolloorrMMoonniittoorr is meaningless if _u_i_t was
       compiled without 'HHAAVVEE__LLIINNUUXX' or LLiinnuuxxCCoonnssoollee is OOFFFF.

       If LLiinnuuxxCCoonnssoollee and CCoolloorrMMoonniittoorr  are  both  OONN,  [[UUIITTxxxxxx--
       CCoolloorr]]  sections  will  be  used in the configuration file
       ..uuiittrrcc.  Otherwise, _u_i_t will use  the  [[UUIITTxxxxxx--MMoonnoocchhrroommee]]
       sections.   The  discussion  above applies to both _u_i_t and
       _u_i_t_p_s utilities.

       22.. [[UUIITT--SSeettuupp]]

       In this section the variables have only one field.

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

       b.  SSttaarrttuuppLLeeffttPPaanneellPPaatthh
       c.  SSttaarrttuuppRRiigghhttPPaanneellPPaatthh
        -  those  variables  specifies  the startup path for each
       panel.

       d.  NNoorrmmaallMMooddeeHHeellpp
       e.  CCoommmmaannddLLiinneeMMooddeeHHeellpp
        - those variables describe the status  bar  contents  for
       each _u_i_t mode when no errors occurred. See also <<SShhoowwTTttyy>>.

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

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

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

       In this sections the variables have only one field.



Release 4.1c                April 1994                          3





uit(1)                                                     uit(1)


       These sections permits you to customize the colors of  _u_i_t
       and  _u_i_t_p_s.   Reading the ..uuiittrrcc configuration file should
       be self explanatory.  See also the [[SSeettuupp]] section.

       33.. [[KKeeyyss]]

       This section describes the actions _u_i_t takes when a speci-
       fied key is pressed. In this section a variable could have
       up to 6 fields separated by ';'.  Each line in  this  sec-
       tion will look like:

       kkeeyy__nnaammee = ccoommmmaanndd__nnaammee;ffoorrmmaatttteedd__ccoommmmaanndd;nneeww__ddiirr;
                  ssaavvee__ssccrreeeenn;ppaauussee;hhiiddee

       WWAARRNNIINNGG  : you can't continue the variable fields descrip-
       tion on the next line.


       a.  kkeeyy__nnaammee
        - kkeeyy__nnaammee is the name of the  key  associated  with  the
       given  command.  Only the keys listed in the configuration
       file can be used.

       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__nnaammee).  If it  is  not,  no
       action  will  be  taken when pressing kkeeyy__nnaammee..  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  ccoomm--
       mmaanndd__nnaammee  section  contains a built-in command specifica-
       tion, 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>>
        - makes directories.

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

       <<EExxiitt>>
        - exits _u_i_t.

       <<HHiissttoorryyBBaacckk>>
        - copies to the command line the previous command in  the



Release 4.1c                April 1994                          4





uit(1)                                                     uit(1)


       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 com-
       mand line.

       <<FFiilleeDDiissppllaayyMMooddee>>
        - changes the file display mode.

       <<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 uns-
       elected files becomes selected.

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

       <<HHoommee>>
        -  puts  the  cursor  onto the first entry in the current
       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 directory
       file list.

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

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




Release 4.1c                April 1994                          5





uit(1)                                                     uit(1)


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

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

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

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

       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 ssppeecciiffiieerrss:

        - %%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' could contain
       any other format specifiers 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.




Release 4.1c                April 1994                          6





uit(1)                                                     uit(1)


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

       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.

       e.  ssaavvee__ssccrreeeenn
        - this field is an integer (usually 0 or 1) who tells _u_i_t
       to save (1) or not to save (0) the terminal  screen  after
       executing the ffoorrmmaatttteedd__ccoommmmaanndd..  Saving the screen is not
       necessary while editing or  viewing  a  file  because  the
       information  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 1.

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

       g.  hhiiddee
        - there are some commands that aren't displaying any use-
       ful 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  1, 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



Release 4.1c                April 1994                          7





uit(1)                                                     uit(1)


       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 TTeemmppDDiirreeccttoorryy
       specified in the [[SSeettuupp]] section. By default this field is
       0.

       The  default configuration file $$HHOOMMEE//..uuiittrrcc 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 rreemmoovvee/aadddd new commands.


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


MMOOUUSSEE SSUUPPPPOORRTT
       _u_i_t  doesn't use the mouse, but, if you are running Linux,
       you can use the sseelleeccttiioonn utility to get  characters  form
       screen and insert them in the terminal keyboard queue.


MMIINNUUSSEESS
       11..   Files  can't  be moved from a file system to another.
       You have to copy then delete them instead.  Before  trying
       to  make  a  link  from the destination file to the source
       file, _u_i_t deletes the destination file (if  existent),  so
       take  care not to lose some data trying to move files in a
       wrong way.

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

       33..  No command line editing is provided. You can only mod-
       ify the contents of the  command  line  by  appending  new
       characters or deleting them with backspace.

       44..   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
       file.  ..uuiittrrcc should be  configured  with  CCoolloorrMMoonniittoorr  ==
       OOFFFF.  If you are working on a serial b/w tty, LLiinnuuxxCCoonnssoollee
       should be OOFFFF too.

       55..  Only PPOOSSIIXX terminals are supported.




Release 4.1c                April 1994                          8





uit(1)                                                     uit(1)


       66..  No tteerrmmiinnffoo support is provided. No problems, you  can
       use the ..uuiitttteerrmmccaapp file to get termcap support.


BBUUGGSS
       11..  kkuu,, kkdd,, kkrr aanndd kkll terminal capabilities for vvtt110000 fam-
       ily sends EESSCC ]] AA , EESSCC ]] BB , EESSCC ]] CC and EESSCC ]] DD  (normal
       mode). Every //eettcc//tteerrmmccaapp I saw defines these capabilities
       as EESSCC OO AA , EESSCC OO BB , EESSCC OO CC and EESSCC  OO  DD  (application
       mode). This is not a very big problem because you can copy
       the vvtt110000 termcap description in the ..uuiitttteerrmmccaapp file  and
       modify it to suit your terminal key codes.

       22..   Only  the AANNSSII 'ccmm' terminal capability is supported.
       So, if your ccmm capability is not EESSCC [[%%ii%%dd;;%%ddHH, _u_i_t  won't
       work.  In order to make _u_i_t work with a different ccmm defi-
       nition  a  small  modification  is  required  in  ttttyy..cc  (
       ttttyy__ccuurrssoorrmmoovvee((iinntt,, iinntt))) to suit your 'ccmm' definition.

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


SSEEEE AALLSSOO
       termcap(5) ps(1)


FFIILLEESS
       /usr/bin/uit
       /usr/bin/uitps
       /usr/bin/uitview
       /usr/bin/uitcmp
       /usr/man/man1/uit.1
       $HOME/.uitrc
       $HOME/.uittermcap


AAUUTTHHOORRSS
       _T_u_d_o_r _H_u_l_u_b_e_i
       _A_n_d_r_e_i _P_i_t_i_s
       PPoolliitteecchhnniicc UUnniivveerrssiittyy ooff BBuucchhaarreesstt
       RRoommaanniiaa
















Release 4.1c                April 1994                          9


