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