home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / Documentation / PUPS / Programs / Arcutils / getunix.README < prev    next >
Encoding:
Text File  |  1995-11-02  |  4.7 KB  |  133 lines

  1.  
  2.  
  3.  
  4. GETUNIX(1)                                             GETUNIX(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        cp11, cpv, cpu; ls11, lsv, lsu - read UNIX filesystems
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ccpp?  [options] sourcefile [targetfile]
  12.        llss?  [options] directory
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        _C_p?   retrieves the named _s_o_u_r_c_e_f_i_l_e from a UNIX file sys-
  16.        tem.  If a _t_a_r_g_e_t_f_i_l_e is specified,  the  copy  is  placed
  17.        there;  otherwise  the contents of the file are written to
  18.        standard output.  If the _t_a_r_g_e_t_f_i_l_e named is a  directory,
  19.        the  file  is  copied  there with the same basename as the
  20.        original.
  21.  
  22.        _L_s?  is similar to _c_p?  (in fact, it is merely a  link  to
  23.        it),  but  lists the contents of the directory _s_o_u_r_c_e_f_i_l_e;
  24.        if the file is not a directory, it is  listed  by  itself.
  25.        Normally,  just  filenames  are  listed; if the --ll flag is
  26.        given, more information (protection, modes) is printed.
  27.  
  28.        Other options recognized by both _c_p_?  and _l_s_?:
  29.  
  30.  
  31.        --dd device Filesystem  resides  on  the  named  _d_e_v_i_c_e  (or
  32.                  file), rather than the default.
  33.  
  34.        --vv        Filesystem is a VAX (32V) filesystem.
  35.  
  36.        --77        Filesystem is a version 7 filesystem.
  37.  
  38.        --66        Filesystem is a version 6 filesystem.
  39.  
  40.        --ss        Silent mode; error messages are suppressed.
  41.  
  42. FFIILLEESS
  43.        /dev/v*   VAX filesystems
  44.        /dev/v7*  V7 filesystems
  45.        /dev/v6*  V6 filesystems
  46.        /bin/sort
  47.  
  48. SSEEEE AALLSSOO
  49.        ls(1)
  50.  
  51. DDIIAAGGNNOOSSTTIICCSS
  52.        Most are self-explanatory.
  53.  
  54.        "File has hole(s)" means that the file contains an unallo-
  55.        cated block.  This usually indicates something weird  with
  56.        the  file,  but  may  be a normal condition.  Holes in the
  57.        output file are created as allocated  blocks  filled  with
  58.        zeros.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                HEP                              1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. GETUNIX(1)                                             GETUNIX(1)
  71.  
  72.  
  73. HHEEPP IINNFFOO
  74.        Written  at  HEP  by  Rob Pike.  Modified by Mark Bartelt.
  75.        Further hacked by Norman Wilson.   Hacked  still  more  by
  76.        Mark Bartelt.
  77.  
  78.        On  the  UNIX VAX, the program is named _c_p_1_1 and _l_s_1_1, and
  79.        is used to fetch files  from  the  PDP-11/45  RJE  system.
  80.        Since the RJE system is now running a V7 system, --77 is the
  81.        default.
  82.  
  83.        On the 11/45, the program is named _c_p_v  and  _l_s_v,  and  is
  84.        used to fetch files from the VAX.  The default is --vv.
  85.  
  86.        Now  also  runs  under  VMS (ported via EUNICE), where the
  87.        disks containing UNIX filesystems are mounted foreign with
  88.        names $UNIX0, $UNIX1, and so forth.  The following foreign
  89.        commands are defined:
  90.             cpu*nix :== $sys$sysdisk:[bin]getunix cpunix
  91.             lsu*nix :== $sys$sysdisk:[bin]getunix lsunix
  92.             cpv*ax :== $sys$sysdisk:[bin]getunix cpvax
  93.             lsv*ax :== $sys$sysdisk:[bin]getunix lsvax
  94.             cp11 :== $sys$sysdisk:[bin]getunix cp11
  95.             ls11 :== $sys$sysdisk:[bin]getunix ls11
  96.  
  97.        On the VMS VAX, _c_p_u_/_l_s_u (and _c_p_v_/_l_s_v) are  used  to  fetch
  98.        files from the UNIX VAX, _c_p_1_1_/_l_s_1_1 to fetch files from the
  99.        11/45.  Defaults are, obviously, --vv and --77,  respectively.
  100.  
  101.        File  protection modes are checked to ensure that the per-
  102.        son running the program actually  has  appropriate  access
  103.        permission.   When  running  under VMS, the access test is
  104.        modified somewhat: Since there is no convenient way to map
  105.        UNIX UIDs and VMS UIC member numbers onto each other, only
  106.        group and world access are checked.  Furthermore, a  group
  107.        match is defined to exist if the decimal representation of
  108.        the UNIX GID is the same as the  octal  representation  of
  109.        the  VMS  UIC  group  number.  This is done to make things
  110.        easier for people who set up accounts: If a group  on  the
  111.        VMS  machine is, say, 123 (octal), that same group must be
  112.        123 (decimal) on the UNIX machines, and vice-versa.   For-
  113.        tunately,  that's  the  way  things are set up here.  Note
  114.        that files which are readable  only  to  owner  cannot  be
  115.        copied to the VMS system.
  116.  
  117.        The  UNIX  version needs to read ``cooked'' devices rather
  118.        than ``raw'' ones, since it does _l_s_e_e_ks that aren't whole-
  119.        block multiples.
  120.  
  121.        The VMS version of _l_s?  does not produce sorted output.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                HEP                              2
  131.  
  132.  
  133.