home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / decus / RB125 / attrib.mem < prev    next >
Text File  |  1995-06-04  |  43KB  |  1,149 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                 ATTRIB                                ATTRIB                                ATTRIB                                ATTRIB
  11.                  File Attribute Manipulation Utility
  12.                            Reference Manual
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                             February 1987
  24.  
  25. This  document  describes  the  ATTRIB  File  Attribute   Manipulation
  26. Utility.  This utility is unlicensed and unsupported.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35. Revision/Update Information:       This is a new manual.
  36.  
  37. Operating System and Version:      MS-DOS* version 2.10 or later.
  38.  
  39. Software Version:                  ATTRIB version 1.0
  40.  
  41.                                                     NOT                                                    NOT                                                    NOTSupport:                           THIS SOFTWARE IS NOT  SUPPORTED  BY
  42.                                    DIGITAL EQUIPMENT CORPORATION.
  43.  
  44. Direct Questions and Comments To:  Brian Hetrick
  45.                                    ZKO1-3/J10
  46.                                    Digital Equipment Corporation
  47.                                    110 Spit Brook Road
  48.                                    Nashua NH 03062-2698
  49.                                    USA
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56. * MS-DOS is a trademark of Microsoft Corporation.
  57.  
  58. Digital Equipment Corporation                    Maynard Massachusetts
  59.                                                          February 1987
  60.  
  61.  
  62.  
  63.  
  64.  
  65. The information in this document is subject to change  without  notice
  66. and  should  not  be  construed  as  a commitment by Digital Equipment
  67. Corporation.  Digital Equipment Corporation assumes no  responsibility
  68. for any errors that may appear in this document.
  69.  
  70. The software described in this document is unlicensed and unsupported.
  71. Digital Equipment Corporation assumes no responsibility for the use orDigital Equipment Corporation assumes no responsibility for the use orDigital Equipment Corporation assumes no responsibility for the use orDigital Equipment Corporation assumes no responsibility for the use or
  72. reliability of this softwarereliability of this softwarereliability of this softwarereliability of this software.  This  software  is  provided  "as  is,"
  73. without  any  warranty  of  any  kind,  express  or  implied.  Digital
  74. Equipment Corporation will not be liable in any event for any  damages
  75. including  any  loss  of  data, profit, or savings, claims against the
  76. user by any other party, or  any  other  incidental  or  consequential
  77. damages arising out of the use of, or inability to use, this software,
  78. even if Digital Equipment Corporation is advised of the possibility of
  79. such damage.
  80.  
  81.  
  82.  
  83.  
  84.  
  85. This documentation and the software it describes have been placed into
  86. the public domain by Digital Equipment Corporation.
  87.  
  88.  
  89.  
  90.  
  91.  
  92. The following are trademarks of Digital Equipment Corporation:
  93.  
  94.     DEC             MASSBUS         RSX             VAX
  95.     DECmate         PDP             RT              VAXcluster
  96.     DECnet          P/OS            ULTRIX          VAXmate
  97.     DECUS           Professional    ULTRIX-32       VMS
  98.     DECwriter       Rainbow         ULTRIX-32M      VT
  99.     DIBOL           RSTS            UNIBUS          Work Processor
  100.                             _ _ _ _ _ _ _
  101.                            | | | | | | | |
  102.                            |d|i|g|i|t|a|l|
  103.                            |_|_|_|_|_|_|_|
  104.                                Contents                               Contents                               Contents                               Contents
  105.  
  106.  
  107.  
  108.                                                                   Page
  109.  
  110. Preface                                                              v
  111.     Intended Audience                                                v
  112.     Structure of This Document                                       v
  113.     Associated Documents                                             v
  114.     Conventions Used in This Document                                v
  115.     Acknowledgments                                                 vi
  116.  
  117. Summary                                                              1
  118.     Format                                                           1
  119.         Command Qualifiers                                           1
  120.         Command Parameters                                           1
  121.  
  122.     Usage                                                            1
  123.         Invoking                                                     1
  124.         Exiting                                                      1
  125.         Directing Output                                             2
  126.  
  127. Description                                                          3
  128.     Invoking the File Attribute Manipulation Utility                 3
  129.     Command Parameters                                               3
  130.     Display of File Names and Attributes                             5
  131.     Command Qualifiers                                               6
  132.     Restrictions                                                     6
  133.  
  134. Command Qualifiers                                                   7
  135.     /HELP Command Qualifier                                          7
  136.         Format                                                       7
  137.         Description                                                  7
  138.         Example                                                      7
  139.  
  140.     /LOG Command Qualifier                                           8
  141.         Format                                                       8
  142.         Description                                                  8
  143.         Example                                                      8
  144.  
  145.     /RESET Command Qualifier                                         9
  146.         Format                                                       9
  147.         Description                                                  9
  148.         Example                                                     10
  149.  
  150.     /SET Command Qualifier                                          11
  151.         Format                                                      11
  152.         Description                                                 11
  153.         Example                                                     12
  154.  
  155. Examples                                                            13
  156.     Avoiding Full Backup After Restore                              13
  157.     Avoiding Full Backup After Failed Incremental Backup            13
  158.     Making a File Invisible                                         14
  159.     Making a File Visible                                           14
  160.     Making a File Unmodifiable                                      14
  161.     Making a File Modifiable                                        15
  162.  
  163.                                    File Attribute Manipulation Utility
  164.                                                                Preface
  165.  
  166.  
  167.                                Preface                               Preface                               Preface                               Preface
  168.  
  169.  
  170. Intended AudienceIntended AudienceIntended AudienceIntended Audience
  171.  
  172.      This manual is intended for all MS-DOS users.
  173.  
  174.  
  175. Structure of This DocumentStructure of This DocumentStructure of This DocumentStructure of This Document
  176.  
  177.      This document has four major sections:
  178.  
  179.       o  The Summary section is an  overview  of  the  File  Attribute
  180.          Manipulation  Utility  and  is  intended as a quick reference
  181.          guide.  The Format  subsection  describes  the  command  that
  182.          invokes  the File Attribute Manipulation Utility, listing all
  183.          command qualifiers  and  parameters.   The  Usage  subsection
  184.          describes  how  to  invoke  the  File  Attribute Manipulation
  185.          Utility and how to redirect output.
  186.  
  187.       o  The  Description  section  explains  how  to  use  the   File
  188.          Attribute Manipulation Utility and lists any restrictions you
  189.          should be aware of.
  190.  
  191.       o  The  Command  Qualifier  section   describes   each   command
  192.          qualifier.   This  section  lists  the  command qualifiers in
  193.          alphabetical order.
  194.  
  195.       o  The Examples section contains examples of  common  operations
  196.          that   you  perform  with  the  File  Attribute  Manipulation
  197.          Utility.
  198.  
  199.  
  200. Associated DocumentsAssociated DocumentsAssociated DocumentsAssociated Documents
  201.  
  202.      To use the File Attribute Manipulation Utility, you  should  also
  203.      be familiar with the following manual:
  204.  
  205.          ______ ______ _____      ____  _________  ______      o  MS-DOS User's Guide, or  Disk  Operating  System  manual,  as
  206.          appropriate.
  207.  
  208.  
  209. Conventions Used in This DocumentConventions Used in This DocumentConventions Used in This DocumentConventions Used in This Document
  210.  
  211.      Convention                    Meaning
  212.  
  213.        ATTRIB /SET:SYSTEM *.*       ATTRIB /SET:SYSTEM *.*       ATTRIB /SET:SYSTEM *.*     E>ATTRIB /SET:SYSTEM *.*      Command examples show output  lines
  214.                                    or  prompting  characters  that the
  215.                                    system prints or displays in normal
  216.                                    type.   All  user-entered  commands
  217.                                                 bold                                                bold                                                bold                                   are shown in bold type.
  218.  
  219.  
  220.                                   v
  221. File Attribute Manipulation Utility
  222. Preface
  223.  
  224.  
  225.      /[NO]LOG                      Format  descriptions   use   square
  226.                                    brackets   to   indicate  that  the
  227.                                    enclosed item is optional.
  228.  
  229.             ________  _________     ATTRIB wildspec [qualifier]   Format   descriptions   show    all
  230.                                    portions  of the command or command
  231.                                    qualifier.  Upper case letters  and
  232.                                    special  characters must be entered
  233.                                    exactly  as  shown.    Lower   case
  234.                                    italic letters indicate portions of
  235.                                    the  command  for  which  you  must
  236.                                    substitute  values  which determine
  237.                                    the effect of the command.
  238.  
  239.            _____  _____     /SET:(value[,value]...)       Ellipses    (...)     in     format
  240.                                    descriptions   indicate   that  the
  241.                                    immediately preceding item  may  be
  242.                                    repeated several times.
  243.  
  244.      <CTRL/x>                      The symbol <CTRL/x> indicates  that
  245.                                    you must press the key labeled CTRL
  246.                                    while  you   simultaneously   press
  247.                                    another key, for example, <CTRL/C>.
  248.  
  249.  
  250. AcknowledgmentsAcknowledgmentsAcknowledgmentsAcknowledgments
  251.  
  252.      The ATTRIB File Attribute Manipulation Utility  uses  the  public
  253.      domain  command  line  parsing  package written by Bela Lubkin of
  254.      Borland International Inc.
  255.  
  256.      Several employees of Digital Equipment Corporation served as beta
  257.      testers  for  various  preliminary versions of this documentation
  258.      and the software it describes.  The author thanks  these  persons
  259.      for their contribution to this utility.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.                                   vi
  279.                                    File Attribute Manipulation Utility
  280.                                                                Summary
  281.  
  282.  
  283.                                Summary                               Summary                               Summary                               Summary
  284.  
  285.  
  286.      The ATTRIB File Attribute Manipulation  Utility  displays,  sets,
  287.      and resets attributes of files.
  288.  
  289.  
  290. FormatFormatFormatFormat
  291.  
  292.              ________      _________     ATTRIB [wildspec]... [qualifier]...
  293.  
  294.      Command Qualifiers            Defaults     Command Qualifiers            Defaults     Command Qualifiers            Defaults     Command Qualifiers            Defaults
  295.  
  296.      /[NO]HELP                     /NOHELP
  297.      /[NO]LOG                      /LOG
  298.             _____     /RESET:value                  [none]
  299.           _____     /SET:value                    [none]
  300.  
  301.      Command Parameters     Command Parameters     Command Parameters     Command Parameters
  302.  
  303.      ________     wildspec
  304.  
  305.           A path  specification,  the  last  component  of  which  may
  306.           contain  wild  card  characters,  describing the files whose
  307.           attributes are to be displayed, set, or reset.   If  several
  308.           path specifications are given, each is processed in turn.
  309.  
  310.      Command parameters and command qualifiers may  be  given  in  any
  311.      order.
  312.  
  313.  
  314. UsageUsageUsageUsage
  315.  
  316.      Invoking     Invoking     Invoking     Invoking
  317.  
  318.           You invoke the File Attribute Manipulation Utility with  the
  319.           ATTRIB command.
  320.  
  321.      Exiting     Exiting     Exiting     Exiting
  322.  
  323.           You exit the File Attribute Manipulation Utility normally by
  324.           waiting  until  processing  is complete.  The File Attribute
  325.           Manipulation Utility will  return  control  to  the  command
  326.           interpreter when processing is complete.
  327.  
  328.           You  can  exit  the  File  Attribute  Manipulation   Utility
  329.           abnormally   by  typing  <CTRL/C>,  if  the  /NOLOG  command
  330.           qualifier  has  not  been  given  or  if  the  MS-DOS  BREAK
  331.           parameter is ON.
  332.  
  333.  
  334.  
  335.  
  336.                                   1
  337. File Attribute Manipulation Utility
  338. Summary
  339.  
  340.  
  341.      Directing Output     Directing Output     Directing Output     Directing Output
  342.  
  343.           By default, messages from the  File  Attribute  Manipulation
  344.           Utility  are  directed to the console device.  Such messages
  345.           may be redirected to another device or a file with  the  I/O
  346.           redirection facilities of the command interpreter.
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                   2
  395.                                    File Attribute Manipulation Utility
  396.                                                            Description
  397.  
  398.  
  399.                              Description                             Description                             Description                             Description
  400.  
  401.  
  402.      The  File  Attribute  Manipulation  Utility  is  a   command-line
  403.      oriented  program  used  to  display,  set, and reset file system
  404.      attributes of individual files or groups of files.
  405.  
  406.      Through the use of the File Attribute Manipulation  Utility,  you
  407.      can  display  the names of hidden and system files, protect files
  408.      against alteration or deletion, make files eligible or ineligible
  409.      for  display  with  the MS-DOS DIR command, and force files to be
  410.      backed up or not backed up with an incremental backup utility.
  411.  
  412.  
  413. Invoking the File Attribute Manipulation UtilityInvoking the File Attribute Manipulation UtilityInvoking the File Attribute Manipulation UtilityInvoking the File Attribute Manipulation Utility
  414.  
  415.      You invoke the  File  Attribute  Manipulation  Utility  with  the
  416.      ATTRIB command, optionally followed by one or more wild card path
  417.      specifications of the files whose attributes are to be  displayed
  418.      or manipulated.
  419.  
  420.      If you do not specify any wild card path specifications and  also
  421.      do  not  specify  any  command  qualifiers,  the  File  Attribute
  422.      Manipulation Utility will display the names and attributes of all
  423.      files  in  the  current  directory  of  the volume in the current
  424.      drive.
  425.  
  426.      If you specify command qualifiers other than  /HELP  but  do  not
  427.      specify  any  wild  card  path specifications, the File Attribute
  428.      Manipulation Utility will take no action.
  429.  
  430.      If you specify at least one wild  card  path  specification,  the
  431.      File  Attribute  Manipulation Utility will process all files with
  432.      names matching the wild card path specifications and then exit.
  433.  
  434.  
  435. Command ParametersCommand ParametersCommand ParametersCommand Parameters
  436.  
  437.      The File Attribute Manipulation Utility processes the files whose
  438.      names  are  selected  by  the wild card path specifications.  For
  439.      example, the following command displays the attributes and  names
  440.      of all files on the current directory of the volume in drive C:
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.                                   3
  453. File Attribute Manipulation Utility
  454. Description
  455.  
  456.  
  457.             ATTRIB C:*.*            ATTRIB C:*.*            ATTRIB C:*.*          E>ATTRIB C:*.*
  458.           ATTRIB version 1.0
  459.  
  460.           C:\*.*:
  461.             IBMBIO.COM    Arc     R/O Hid Sys
  462.             IBMDOS.COM    Arc     R/O Hid Sys
  463.             AUTOEXEC.BAT  Arc
  464.             BIN               Dir
  465.             LIB               Dir
  466.             USR               Dir
  467.             CONFIG.SYS    Arc
  468.             M2LOD             Dir
  469.             M2LIB             Dir
  470.  
  471.      If a drive letter is specified in a wild card path specification,
  472.      the  path  is  interpreted  as  residing  on  the  volume  in the
  473.      specified drive.  Otherwise, the path is interpreted as  residing
  474.      on  the  current  default  drive.  If the path starts with a back
  475.      slash (\), the path  is  interpreted  as  relative  to  the  root
  476.      directory  of  the volume.  Otherwise, the path is interpreted as
  477.      relative to the current default directory of the volume.  In  all
  478.      of  these  cases,  the  absolute  form  of  the  wild  card  path
  479.      specification is displayed, followed by a line for  each  of  the
  480.      files selected by the wild card path specification.
  481.  
  482.      The last component  of  the  path  specifications  given  in  the
  483.      command may contain wild card characters.  An asterisk (*) in the
  484.      file name portion of the last component of the path specification
  485.      indicates  that  all  files  whose names match the portion of the
  486.      file name before the asterisk will match the file  name  portion.
  487.      An  asterisk  as  the  first  or  only character of the file name
  488.      portion of the last component  of  the  path  specification  will
  489.      match  the file name of all files.  Similarly, an asterisk in the
  490.      file  extension  portion  of  the  last  component  of  the  path
  491.      specification indicates that all files whose extensions match the
  492.      portion of the file extension before the asterisk will match  the
  493.      file  extension  portion.   An  asterisk  as  the  first  or only
  494.      character of the file extension portion of the last component  of
  495.      the  path  specification  will  match  the  file extension of all
  496.      files.
  497.  
  498.      A question mark (?) in any position of the last component of  the
  499.      path specification will match any single character in a file name
  500.      or file extension.  Question marks as the last characters of  the
  501.      file name or file extension portions of the last component of the
  502.      path specification will also match null (nonexistent)  characters
  503.      of the file name or file extension.
  504.  
  505.      If the current directory on the volume in drive  B  is  the  root
  506.      directory, then the command:
  507.  
  508.  
  509.  
  510.                                   4
  511.                                    File Attribute Manipulation Utility
  512.                                                            Description
  513.  
  514.  
  515.             ATTRIB B:???.D*            ATTRIB B:???.D*            ATTRIB B:???.D*          E>ATTRIB B:???.D*
  516.  
  517.      will list the attributes and names  of  all  files  in  the  root
  518.      directory  of  the volume in drive B whose file names are at most
  519.      three characters long, and whose file extensions start  with  the
  520.      letter D.
  521.  
  522.      Except in the root directory of a volume, a single period (.)  in
  523.      the place of a directory name refers to the directory which would
  524.      be specified in the absence of the period, while two periods (..)
  525.      refers to the parent of the directory which would be specified in
  526.      the absence of the two periods.  When the directory  which  would
  527.      be  specified  without  the  periods  is  the root directory of a
  528.      volume, both a single period and two periods refers to  the  root
  529.      directory.  A single back slash also refers to the root directory
  530.      of a volume.
  531.  
  532.      If the path specification ends in either a colon (:)  or  a  back
  533.      slash  (\),  the  File Attribute Manipulation Utility appends the
  534.      wild card specification *.* to the path appearing in the  command
  535.      line.  For example, the command:
  536.  
  537.             ATTRIB A:            ATTRIB A:            ATTRIB A:          E>ATTRIB A:
  538.  
  539.      lists the attributes and names of files in the current  directory
  540.      of the volume in drive A.
  541.  
  542.  
  543. Display of File Names and AttributesDisplay of File Names and AttributesDisplay of File Names and AttributesDisplay of File Names and Attributes
  544.  
  545.      The File Attribute Manipulation Utility lists the attributes  and
  546.      names of the files matching each the wild card path specification
  547.      in the following format:
  548.  
  549.           pathspec:
  550.             filename.ext  Arc Dir R/O Hid Sys
  551.  
  552.      "Pathspec" is the wild card path specification specified  in  the
  553.      command  line,  expressed in absolute terms.  It includes a drive
  554.      letter and a complete path specification  relative  to  the  root
  555.      directory of the volume in the drive.
  556.  
  557.      "Filename.ext" is the  name  of  a  file  selected  by  the  path
  558.      specification,  relative  to  the  directory  containing the last
  559.      component of the path specification.
  560.  
  561.      "Arc," if present, indicates that  the  file  has  the  "archive"
  562.      attribute  set.   This  attribute  is  set  whenever  the file is
  563.      written to, and is reset only by  specific  programmed  requests.
  564.      This  attribute  is often used by incremental backup utilities to
  565.      determine whether a file has changed since the last backup.
  566.  
  567.  
  568.                                   5
  569. File Attribute Manipulation Utility
  570. Description
  571.  
  572.  
  573.      "Dir," if present, indicates that the file  has  the  "directory"
  574.      attribute  set.  This attribute is set when the file is an MS-DOS
  575.      subdirectory, rather than a data file.
  576.  
  577.      "R/O," if present, indicates that the file has  the  "read  only"
  578.      attribute  set.   This  attribute  prevents  the  file from being
  579.      written to or deleted.
  580.  
  581.      "Hid," if present, indicates  that  the  file  has  the  "hidden"
  582.      attribute set.  This attribute prevents the file from being found
  583.      by normal directory searches, such as  used  by  the  MS-DOS  DIR
  584.      command.
  585.  
  586.      "Sys," if present, indicates  that  the  file  has  the  "system"
  587.      attribute set.  This attribute prevents the file from being found
  588.      by normal directory searches, such as  used  by  the  MS-DOS  DIR
  589.      command.
  590.  
  591.  
  592. Command QualifiersCommand QualifiersCommand QualifiersCommand Qualifiers
  593.  
  594.      You can obtain a description of the File  Attribute  Manipulation
  595.      Utility's  command  parameters  and  command  qualifiers with the
  596.      /HELP command qualifier.
  597.  
  598.      You can suppress the listing of the  file  names  and  attributes
  599.      with the /NOLOG command qualifier.
  600.  
  601.      You can modify the attributes of  the  files  selected  with  the
  602.      /RESET and /SET command qualifiers.  In this case, the attributes
  603.      listed are the file attributes as modified by the /RESET and /SET
  604.      command  qualifiers,  rather  than  the  file  attributes  before
  605.      modification.
  606.  
  607.  
  608. RestrictionsRestrictionsRestrictionsRestrictions
  609.  
  610.      You cannot set or reset the directory attribute of a file.   This
  611.      is a limitation of the MS-DOS file system.
  612.  
  613.      You can use wild card characters only in the last component of  a
  614.      path specification.  This is a limitation of the directory search
  615.      process provided by the MS-DOS operating system.
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.                                   6
  627.                                    File Attribute Manipulation Utility
  628.                                                     Command Qualifiers
  629.  
  630.  
  631.                        /HELP Command Qualifier                       /HELP Command Qualifier                       /HELP Command Qualifier                       /HELP Command Qualifier
  632.  
  633.  
  634. FormatFormatFormatFormat
  635.  
  636.      /HELP
  637.      /NOHELP
  638.  
  639.  
  640. DescriptionDescriptionDescriptionDescription
  641.  
  642.      By default, the File Attribute Manipulation Utility does not give
  643.      a description of the command parameters and command qualifiers it
  644.      accepts.  The /HELP command qualifier controls the generation  of
  645.      this  description  of  command parameters and command qualifiers.
  646.      If you specify /HELP, the description is produced.  If  you  omit
  647.      the qualifier or specify /NOHELP, no description is produced.
  648.  
  649.      The HELP keyword may be  abbreviated  to  any  leading  substring
  650.      which  does  not  also abbreviate another command qualifier.  The
  651.      minimum abbreviation of the  HELP  keyword  is  H.   The  minimum
  652.      abbreviation of the NOHELP negated keyword construct is NOH.
  653.  
  654.      If the /HELP command qualifier is specified several  times  in  a
  655.      single  command,  the  rightmost  occurrence  of the qualifier is
  656.      effective.
  657.  
  658.  
  659. ExampleExampleExampleExample
  660.  
  661.        ATTRIB /HELP       ATTRIB /HELP       ATTRIB /HELP     E>ATTRIB /HELP
  662.      ATTRIB version 1.0
  663.  
  664.      Command line:   ATTRIB filespec [qualifier]...
  665.  
  666.      'filespec' is a path specification possibly with wild card characters
  667.         in the last component
  668.  
  669.      'qualifier' is one of /[NO]HELP, /[NO]LOG, /SET:value, /RESET:value,
  670.         /CLEAR:value, /REMOVE:value
  671.  
  672.         /SET grants attributes
  673.         /RESET, /CLEAR, and /REMOVE remove attributes
  674.  
  675.      'value' is either name or (name[,name]...)
  676.  
  677.      'name' is one of ARCHIVE, HIDDEN, SYSTEM, READ_ONLY
  678.  
  679.      All keywords may be uniquely abbreviated
  680.  
  681.  
  682.  
  683.  
  684.                                   7
  685. File Attribute Manipulation Utility
  686. Command Qualifiers
  687.  
  688.  
  689.                         /LOG Command Qualifier                        /LOG Command Qualifier                        /LOG Command Qualifier                        /LOG Command Qualifier
  690.  
  691.  
  692. FormatFormatFormatFormat
  693.  
  694.      /LOG
  695.      /NOLOG
  696.  
  697.  
  698. DescriptionDescriptionDescriptionDescription
  699.  
  700.      By default, the File Attribute  Manipulation  Utility  lists  the
  701.      attributes  and  names of all files selected by the command line.
  702.      The  /LOG  command  qualifier  controls  this  listing  of   file
  703.      attributes  and  names.   If  you  specify  /NOLOG, no listing is
  704.      produced.  If you omit the qualifier or specify /LOG, the listing
  705.      is produced.
  706.  
  707.      The LOG keyword may be abbreviated to any leading substring which
  708.      does  not also abbreviate another command qualifier keyword.  The
  709.      minimum abbreviation of  the  LOG  keyword  is  L.   The  minimum
  710.      abbreviation of the NOLOG negated keyword construct is NOL.
  711.  
  712.      If the /LOG command qualifier is specified  several  times  in  a
  713.      single  command,  the  rightmost  occurrence  of the qualifier is
  714.      effective.
  715.  
  716.  
  717. ExampleExampleExampleExample
  718.  
  719.        ATTRIB /SET:SYSTEM *.* /NOLOG       ATTRIB /SET:SYSTEM *.* /NOLOG       ATTRIB /SET:SYSTEM *.* /NOLOG     E>ATTRIB /SET:SYSTEM *.* /NOLOG
  720.      ATTRIB version 1.0
  721.  
  722.        ATTRIB *.*       ATTRIB *.*       ATTRIB *.*     E>ATTRIB *.*
  723.      ATTRIB version 1.0
  724.  
  725.      E:\*.*:
  726.        ABSTRACT          Dir         Sys
  727.        M2LIB             Dir         Sys
  728.        M2LOD             Dir         Sys
  729.  
  730.        ATTRIB *.* /RESET:SYSTEM /LOG       ATTRIB *.* /RESET:SYSTEM /LOG       ATTRIB *.* /RESET:SYSTEM /LOG     E>ATTRIB *.* /RESET:SYSTEM /LOG
  731.      ATTRIB version 1.0
  732.  
  733.      E:\*.*:
  734.        ABSTRACT          Dir
  735.        M2LIB             Dir
  736.        M2LOD             Dir
  737.  
  738.  
  739.  
  740.  
  741.  
  742.                                   8
  743.                                    File Attribute Manipulation Utility
  744.                                                     Command Qualifiers
  745.  
  746.  
  747.                        /RESET Command Qualifier                       /RESET Command Qualifier                       /RESET Command Qualifier                       /RESET Command Qualifier
  748.  
  749.  
  750. FormatFormatFormatFormat
  751.  
  752.             _____     /RESET:value
  753.              _____  _____     /RESET:(value[,value]...)
  754.             _____     /CLEAR:value
  755.              _____  _____     /CLEAR:(value[,value]...)
  756.              _____     /REMOVE:value
  757.               _____  _____     /REMOVE:(value[,value]...)
  758.  
  759.  
  760. DescriptionDescriptionDescriptionDescription
  761.  
  762.      By  default,  the  File  Attribute  Manipulator  Utility   leaves
  763.      unchanged  the  attributes of the files selected by the wild card
  764.      path specifications.  The /RESET command  qualifier  directs  the
  765.      File  Attribute  Manipulation  Utility to reset (remove) specific
  766.      attributes for the selected files.  The value specified  for  the
  767.      /RESET command qualifier may be a single item from the list:
  768.  
  769.           ARCHIVE - Specifying this item directs  the  File  Attribute
  770.                Manipulator Utility to reset the "archive" attribute
  771.  
  772.           HIDDEN - Specifying this item  directs  the  File  Attribute
  773.                Manipulator Utility to reset the "hidden" attribute
  774.  
  775.           READ_ONLY - Specifying this item directs the File  Attribute
  776.                Manipulator Utility to reset the "read only" attribute
  777.  
  778.           SYSTEM - Specifying this item  directs  the  File  Attribute
  779.                Manipulator Utility to reset the "system" attribute
  780.  
  781.      The value specified for the /RESET command qualifier may also  be
  782.      a  combination  of these values, separated by commas and enclosed
  783.      in parentheses.
  784.  
  785.      The ARCHIVE,  HIDDEN,  READ_ONLY,  and  SYSTEM  keywords  may  be
  786.      abbreviated   to  any  leading  substring  which  does  not  also
  787.      abbreviate another of these keywords.  The minimum  abbreviations
  788.      of these keywords are A, H, R, and S, respectively.
  789.  
  790.      The CLEAR, REMOVE, and RESET keywords are synonyms.   The  CLEAR,
  791.      REMOVE,  and  RESET  keywords  may  be abbreviated to any leading
  792.      substring  which  does  not  also  abbreviate   another   command
  793.      qualifier  keyword.   The  minimum abbreviation of these keywords
  794.      are C, R, and R, respectively.  R and RE are  accepted  for  both
  795.      the REMOVE and RESET keywords as these keywords are synonyms.
  796.  
  797.      An equals sign (=) may be  used  in  place  of  a  colon  (:)  to
  798.      separate the command qualifier keyword from the command qualifier
  799.  
  800.                                   9
  801. File Attribute Manipulation Utility
  802. Command Qualifiers
  803.  
  804.  
  805.      value.
  806.  
  807.      If the /RESET command qualifier is specified several times  in  a
  808.      single command, attributes appearing in any of the /RESET command
  809.      qualifiers are reset.
  810.  
  811.      No item specified in the /RESET command  qualifier  may  also  be
  812.      specified in the /SET command qualifier.
  813.  
  814.  
  815. ExampleExampleExampleExample
  816.  
  817.        ATTRIB G:\BIN\C*.COM /SET:(ARCHIVE,HIDDEN,READ_ONLY,SYSTEM)       ATTRIB G:\BIN\C*.COM /SET:(ARCHIVE,HIDDEN,READ_ONLY,SYSTEM)       ATTRIB G:\BIN\C*.COM /SET:(ARCHIVE,HIDDEN,READ_ONLY,SYSTEM)     E>ATTRIB G:\BIN\C*.COM /SET:(ARCHIVE,HIDDEN,READ_ONLY,SYSTEM)
  818.      ATTRIB version 1.0
  819.  
  820.      G:\BIN\C*.COM:
  821.        CHKDSK.COM    Arc     R/O Hid Sys
  822.        COMMAND.COM   Arc     R/O Hid Sys
  823.  
  824.        ATTRIB G:\BIN\C*.COM /RESET:HIDDEN       ATTRIB G:\BIN\C*.COM /RESET:HIDDEN       ATTRIB G:\BIN\C*.COM /RESET:HIDDEN     E>ATTRIB G:\BIN\C*.COM /RESET:HIDDEN
  825.      ATTRIB version 1.0
  826.  
  827.      G:\BIN\C*.COM:
  828.        CHKDSK.COM    Arc     R/O     Sys
  829.        COMMAND.COM   Arc     R/O     Sys
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.                                   10
  859.                                    File Attribute Manipulation Utility
  860.                                                     Command Qualifiers
  861.  
  862.  
  863.                         /SET Command Qualifier                        /SET Command Qualifier                        /SET Command Qualifier                        /SET Command Qualifier
  864.  
  865.  
  866. FormatFormatFormatFormat
  867.  
  868.           _____     /SET:value
  869.            _____  _____     /SET:(value[,value]...)
  870.  
  871.  
  872. DescriptionDescriptionDescriptionDescription
  873.  
  874.      By  default,  the  File  Attribute  Manipulator  Utility   leaves
  875.      unchanged  the  attributes of the files selected by the wild card
  876.      path specifications.  The /SET command qualifier directs the File
  877.      Attribute Manipulation Utility to set specific attributes for the
  878.      selected  files.   The  value  specified  for  the  /SET  command
  879.      qualifier may be a single item from the list:
  880.  
  881.           ARCHIVE - Specifying this item directs  the  File  Attribute
  882.                Manipulator Utility to set the "archive" attribute
  883.  
  884.           HIDDEN - Specifying this item  directs  the  File  Attribute
  885.                Manipulator Utility to set the "hidden" attribute
  886.  
  887.           READ_ONLY - Specifying this item directs the File  Attribute
  888.                Manipulator Utility to set the "read only" attribute
  889.  
  890.           SYSTEM - Specifying this item  directs  the  File  Attribute
  891.                Manipulator Utility to set the "system" attribute
  892.  
  893.      The value specified for the /SET command qualifier may also be  a
  894.      combination  of these values, separated by commas and enclosed in
  895.      parentheses.
  896.  
  897.      The ARCHIVE,  HIDDEN,  READ_ONLY,  and  SYSTEM  keywords  may  be
  898.      abbreviated   to  any  leading  substring  which  does  not  also
  899.      abbreviate  another  of  these  four   keywords.    The   minimum
  900.      abbreviations of these keywords are A, H, R, and S, respectively.
  901.  
  902.      The SET keyword may be abbreviated to any leading substring which
  903.      does  not also abbreviate another command qualifier keyword.  The
  904.      minimum abbreviation of the SET keyword is S.
  905.  
  906.      An equals sign (=) may be  used  in  place  of  a  colon  (:)  to
  907.      separate the command qualifier keyword from the command qualifier
  908.      value.
  909.  
  910.      If the /SET command qualifier is specified  several  times  in  a
  911.      single  command,  attributes appearing in any of the /SET command
  912.      qualifiers are set.
  913.  
  914.      No item specified in the  /SET  command  qualifier  may  also  be
  915.  
  916.                                   11
  917. File Attribute Manipulation Utility
  918. Command Qualifiers
  919.  
  920.  
  921.      specified in the /RESET command qualifier.
  922.  
  923.  
  924. ExampleExampleExampleExample
  925.  
  926.        ATTRIB G:\BIN\C*.COM /SET:(HIDDEN,ARCHIVE)       ATTRIB G:\BIN\C*.COM /SET:(HIDDEN,ARCHIVE)       ATTRIB G:\BIN\C*.COM /SET:(HIDDEN,ARCHIVE)     E>ATTRIB G:\BIN\C*.COM /SET:(HIDDEN,ARCHIVE)
  927.      ATTRIB version 1.0
  928.  
  929.      G:\BIN\C*.COM:
  930.        CHKDSK.COM    Arc         Hid
  931.        COMMAND.COM   Arc         Hid
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.                                   12
  975.                                    File Attribute Manipulation Utility
  976.                                                               Examples
  977.  
  978.  
  979.                                Examples                               Examples                               Examples                               Examples
  980.  
  981.  
  982. Avoiding Full Backup After RestoreAvoiding Full Backup After RestoreAvoiding Full Backup After RestoreAvoiding Full Backup After Restore
  983.  
  984.      Many  file  backup  and  restore  utilities  permit   incremental
  985.      backups, where only files having the archive attribute are copied
  986.      from the disk  being  backed  up  to  the  backup  media.   These
  987.      utilities  generally  exactly  restore the files' attributes when
  988.      such files are restored.  At the  next  incremental  backup,  all
  989.      restored  files  are  backed  up  again, as they have the archive
  990.      attribute, this being the reason they were included in the  first
  991.      backup.
  992.  
  993.      You can use the File Attribute Manipulation Utility to reset  the
  994.      archive  attributes  of such files, making them ineligible for an
  995.      incremental backup.  This is useful when large files are restored
  996.      from  a  previous  backup, and it is not desired to back up these
  997.      files yet again.  The command:
  998.  
  999.             ATTRIB /RESET:ARCHIVE *.*            ATTRIB /RESET:ARCHIVE *.*            ATTRIB /RESET:ARCHIVE *.*          E>ATTRIB /RESET:ARCHIVE *.*
  1000.  
  1001.      will reset the archive attribute of  all  files  in  the  current
  1002.      directory of the current drive, making these files ineligible for
  1003.      future incremental backups until their contents are changed.
  1004.  
  1005.  
  1006. Avoiding Full Backup After Failed Incremental BackupAvoiding Full Backup After Failed Incremental BackupAvoiding Full Backup After Failed Incremental BackupAvoiding Full Backup After Failed Incremental Backup
  1007.  
  1008.      Many  file  backup  and  restore  utilities  permit   incremental
  1009.      backups, where only files having the archive attribute are copied
  1010.      from the disk being backed up to the backup media.  Some of these
  1011.      utilities  remove  the  archive attribute from files as the files
  1012.      are copied to the backup media, before it is  known  whether  the
  1013.      backup  as  a  whole  is successful.  With such utilities, if the
  1014.      backup  process  fails  before  completion,  the  files  may   be
  1015.      unrecoverable  from the backup media created by the failed backup
  1016.      process.  Even after the cause of the  backup  utility's  failure
  1017.      has  been  removed,  an  incremental  backup will not back up the
  1018.      files whose archive attributes were removed by the failed  backup
  1019.      process.
  1020.  
  1021.      You can use the File Attribute Manipulation Utility  to  set  the
  1022.      archive  attribute  of the files whose archive attribute has been
  1023.      removed by a failed incremental backup.  The command:
  1024.  
  1025.             ATTRIB /SET:ARCHIVE *.*            ATTRIB /SET:ARCHIVE *.*            ATTRIB /SET:ARCHIVE *.*          E>ATTRIB /SET:ARCHIVE *.*
  1026.  
  1027.      will give the archive attribute  to  all  files  in  the  current
  1028.      directory of the current drive, making these files eligible for a
  1029.      future incremental backup.
  1030.  
  1031.  
  1032.                                   13
  1033. File Attribute Manipulation Utility
  1034. Examples
  1035.  
  1036.  
  1037. Making a File InvisibleMaking a File InvisibleMaking a File InvisibleMaking a File Invisible
  1038.  
  1039.      You can use the File Attribute Manipulation  Utility  to  make  a
  1040.      file undetectable through normal directory searches, such as used
  1041.      by  the  MS-DOS  DIR  command.   Files  with  either  the  hidden
  1042.      attribute  or  the  system attribute are not found through normal
  1043.      directory searches.  The command:
  1044.  
  1045.             ATTRIB /SET:HIDDEN filename            ATTRIB /SET:HIDDEN filename            ATTRIB /SET:HIDDEN filename                               ________                               ________                               ________                               ________          E>ATTRIB /SET:HIDDEN filename
  1046.  
  1047.                                                              ________     will set the hidden attribute of the file specified by  filename,
  1048.      and  so  make  it undetectable through normal directory searches.
  1049.         ________     If filename specifies a subdirectory, then it will not appear  in
  1050.      directory listings, but otherwise will act normally.
  1051.  
  1052.  
  1053. Making a File VisibleMaking a File VisibleMaking a File VisibleMaking a File Visible
  1054.  
  1055.      You can use the File Attribute Manipulation  Utility  to  make  a
  1056.      file  which  has  one  or both of the hidden and system attribute
  1057.      detectable through normal directory searches, such as used by the
  1058.      MS-DOS DIR command.  The command:
  1059.  
  1060.             ATTRIB /RESET:(HIDDEN,SYSTEM) filename            ATTRIB /RESET:(HIDDEN,SYSTEM) filename            ATTRIB /RESET:(HIDDEN,SYSTEM) filename                                          ________                                          ________                                          ________                                          ________          E>ATTRIB /RESET:(HIDDEN,SYSTEM) filename
  1061.  
  1062.      will  reset  the  hidden  and  system  attributes  for  the  file
  1063.                   ________     specified by filename.
  1064.  
  1065.      As files with the hidden or system attributes are not  detectable
  1066.      through  normal  directory  searches, a utility that uses special
  1067.      directory searches must be used to detect  their  presence.   The
  1068.      File  Attribute  Manipulator  Utility  uses  such  searches.  The
  1069.      command:
  1070.  
  1071.             ATTRIB *.*            ATTRIB *.*            ATTRIB *.*          E>ATTRIB *.*
  1072.  
  1073.      will list the attributes and names of all files  in  the  current
  1074.      directory, including files with the hidden or system attributes.
  1075.  
  1076.  
  1077. Making a File UnmodifiableMaking a File UnmodifiableMaking a File UnmodifiableMaking a File Unmodifiable
  1078.  
  1079.      You can make a file ineligible to be  written  upon  or  deleted,
  1080.      with  the File Attribute Manipulation Utility.  This protects the
  1081.      files against accidental deletion or modification.  The command:
  1082.  
  1083.             ATTRIB /SET:READ_ONLY filename            ATTRIB /SET:READ_ONLY filename            ATTRIB /SET:READ_ONLY filename                                  ________                                  ________                                  ________                                  ________          E>ATTRIB /SET:READ_ONLY filename
  1084.  
  1085.                                  ________     gives the file specified by filename  the  read  only  attribute.
  1086.      The  MS-DOS operating system will not permit a file with the read
  1087.      only attribute to be written  upon  or  deleted.   To  modify  or
  1088.      delete  the  file,  it is first necessary to remove the read only
  1089.  
  1090.                                   14
  1091.                                    File Attribute Manipulation Utility
  1092.                                                               Examples
  1093.  
  1094.  
  1095.      attribute.
  1096.  
  1097.  
  1098. Making a File ModifiableMaking a File ModifiableMaking a File ModifiableMaking a File Modifiable
  1099.  
  1100.      You can make a file which has the read  only  attribute  eligible
  1101.      for   modification   and   deletion   using  the  File  Attribute
  1102.      Manipulation Utility.  This would be necessary, for  example,  if
  1103.      you  wanted  to  delete  a  data  file  which  contained obsolete
  1104.      information, but which  had  been  protected  against  accidental
  1105.      modification or deletion.  The command:
  1106.  
  1107.             ATTRIB /RESET:READ_ONLY filename            ATTRIB /RESET:READ_ONLY filename            ATTRIB /RESET:READ_ONLY filename                                    ________                                    ________                                    ________                                    ________          E>ATTRIB /RESET:READ_ONLY filename
  1108.  
  1109.      removes the read  only  attribute  from  the  file  specified  by
  1110.      ________     filename.   The MS-DOS operating system will then permit the file
  1111.      to be written upon or deleted.
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.                                   15
  1149.