~ubuntu-branches/ubuntu/karmic/findutils/karmic

« back to all changes in this revision

Viewing changes to doc/find.info

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2008-02-08 12:31:14 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20080208123114-r10wogrqrq6lck12
Tags: 4.2.32-1ubuntu1
* Merge with Debian; remaining changes:
  - debian/locate-cron.daily: Test if called by root (LP: #147911),
    add /var/lib/schroot/mount to PRUNEPATHS.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
This is ../../findutils/doc/find.info, produced by makeinfo version 4.8
2
 
from ../../findutils/doc/find.texi.
 
1
This is ../../findutils/doc/find.info, produced by makeinfo version
 
2
4.11 from ../../findutils/doc/find.texi.
3
3
 
4
4
INFO-DIR-SECTION Basics
5
5
START-INFO-DIR-ENTRY
17
17
   This file documents the GNU utilities for finding files that match
18
18
certain criteria and performing various operations on them.
19
19
 
20
 
   Copyright (C) 1994, 1996, 1998, 2000, 2001, 2003, 2004, 2005 Free
21
 
Software Foundation, Inc.
22
 
 
23
 
   Permission is granted to make and distribute verbatim copies of this
24
 
manual provided the copyright notice and this permission notice are
25
 
preserved on all copies.
26
 
 
27
 
   Permission is granted to copy and distribute modified versions of
28
 
this manual under the conditions for verbatim copying, provided that the
29
 
entire resulting derived work is distributed under the terms of a
30
 
permission notice identical to this one.
31
 
 
32
 
   Permission is granted to copy and distribute translations of this
33
 
manual into another language, under the above conditions for modified
34
 
versions, except that this permission notice may be stated in a
35
 
translation approved by the Foundation.
 
20
   Copyright (C) 1994, 1996, 1998, 2000, 2001, 2003, 2004, 2005, 2006,
 
21
2007 Free Software Foundation, Inc.
 
22
 
 
23
   Permission is granted to copy, distribute and/or modify this document
 
24
under the terms of the GNU Free Documentation License, Version 1.2 or
 
25
any later version published by the Free Software Foundation; with no
 
26
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
 
27
Texts.  A copy of the license is included in the section entitled "GNU
 
28
Free Documentation License."
36
29
 
37
30
 
38
31
File: find.info,  Node: Top,  Next: Introduction,  Up: (dir)
39
32
 
 
33
GNU Findutils
 
34
*************
 
35
 
 
36
This file documents the GNU utilities for finding files that match
 
37
certain criteria and performing various operations on them.
 
38
 
 
39
   Copyright (C) 1994, 1996, 1998, 2000, 2001, 2003, 2004, 2005, 2006,
 
40
2007 Free Software Foundation, Inc.
 
41
 
 
42
   Permission is granted to copy, distribute and/or modify this document
 
43
under the terms of the GNU Free Documentation License, Version 1.2 or
 
44
any later version published by the Free Software Foundation; with no
 
45
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
 
46
Texts.  A copy of the license is included in the section entitled "GNU
 
47
Free Documentation License."
 
48
 
40
49
   This file documents the GNU utilities for finding files that match
41
50
certain criteria and performing various actions on them.
42
51
 
43
 
   This is edition 4.2.31, for `find' version 4.2.31.
 
52
   This is edition 4.2.32, for `find' version 4.2.32.
44
53
 
45
54
* Menu:
46
55
 
54
63
* Worked Examples::             Examples demonstrating more complex points.
55
64
* Security Considerations::     Security issues relating to findutils.
56
65
* Error Messages::              Explanations of some messages you might see.
 
66
* GNU Free Documentation License::  Copying and sharing this manual.
57
67
* Primary Index::               The components of `find' expressions.
58
68
 
59
69
 
415
425
    `posix-extended'
416
426
          POSIX Extended Regular Expressions
417
427
 
418
 
     *Note Regular Expressions:: for more information on the regular
 
428
     *note Regular Expressions:: for more information on the regular
419
429
     expression dialects understood by GNU findutils.
420
430
 
421
431
 
1119
1129
 
1120
1130
 -- Action: -quit
1121
1131
     Exit immediately (with return value zero if no errors have
1122
 
     occurred).  No child processes will be left running, but no more
1123
 
     files specified on the command line will be processed.  For
1124
 
     example, `find /tmp/foo /tmp/bar -print -quit' will print only
1125
 
     `/tmp/foo'.  Any command lines which have been built by `-exec ...
1126
 
     \+' or `-execdir ... \+' are invoked before the program is
1127
 
     executed.
 
1132
     occurred).  This is different to `-prune' because `-prune' only
 
1133
     applies to the contents of pruned directories, whilt `-quit'
 
1134
     simply makes `find' stop immediately.  No child processes will be
 
1135
     left running, but no more files specified on the command line will
 
1136
     be processed.  For example, `find /tmp/foo /tmp/bar -print -quit'
 
1137
     will print only `/tmp/foo'.  Any command lines which have been
 
1138
     built by `-exec ... \+' or `-execdir ... \+' are invoked before
 
1139
     the program is exited.
1128
1140
 
1129
1141
 -- Option: -noleaf
1130
1142
     Do not optimize by assuming that directories contain 2 fewer
1524
1536
`%b'
1525
1537
     The amount of disk space used for this file in 512-byte blocks.
1526
1538
     Since disk space is allocated in multiples of the filesystem block
1527
 
     size this is usually greater than %s/1024, but it can also be
 
1539
     size this is usually greater than %s/512, but it can also be
1528
1540
     smaller if the file is a sparse file (that is, it has "holes").
1529
1541
 
1530
1542
`%s'
2375
2387
entry begins with an offset-differential count byte, which is the
2376
2388
additional number of characters of prefix of the preceding entry to use
2377
2389
beyond the number that the preceding entry is using of its predecessor.
2378
 
(The counts can be negative.)  Following the count is a
2379
 
null-terminated ASCII remainder--the part of the name that follows the
2380
 
shared prefix.
 
2390
(The counts can be negative.)  Following the count is a null-terminated
 
2391
ASCII remainder--the part of the name that follows the shared prefix.
2381
2392
 
2382
2393
   If the offset-differential count is larger than can be stored in a
2383
2394
byte (+/-127), the byte has the value 0x80 and the count follows in a
2436
2447
and earlier releases of the GNU ones.  `updatedb' produces this format
2437
2448
if given the `--old-format' option.
2438
2449
 
2439
 
   All versions of GNU `locate' prior to 4.2.31 fail to correctly
2440
 
handle very long file names, possibly leading to security problems
2441
 
relating to a heap buffer overrun.  *Note Security Considerations for
2442
 
locate::, for a detailed explanation.
 
2450
   Old versions of GNU `locate' fail to correctly handle very long file
 
2451
names, possibly leading to security problems relating to a heap buffer
 
2452
overrun.  *Note Security Considerations for locate::, for a detailed
 
2453
explanation.
2443
2454
 
2444
2455
   `updatedb' runs programs called `bigram' and `code' to produce
2445
2456
old-format databases.  The old format differs from the new one in the
3002
3013
   If `find' would follow a symbolic link, but cannot for any reason
3003
3014
(for example, because it has insufficient permissions or the link is
3004
3015
broken), it falls back on using the properties of the symbolic link
3005
 
itself.  *Note Symbolic Links:: for a more complete description of how
 
3016
itself.  *note Symbolic Links:: for a more complete description of how
3006
3017
symbolic links are handled.
3007
3018
 
3008
3019
   *Note Primary Index::, for a summary of all of the tests, actions,
3056
3067
   - Specifying an option (for example `-mindepth') after a non-option
3057
3068
     (for example `-type' or `-print') on the command line.
3058
3069
 
 
3070
   - Use of the `-name' or `-iname' option with a slash character in
 
3071
     the pattern.  Since the name predicates only compare against the
 
3072
     basename of the visited files, the only file that can match a
 
3073
     slash is the root directory itself.
 
3074
 
3059
3075
   The default behaviour above is designed to work in that way so that
3060
3076
existing shell scripts don't generate spurious errors, but people will
3061
3077
be made aware of the problem.
3198
3214
 
3199
3215
`--regextype'
3200
3216
     This option changes the regular expression syntax and behaviour
3201
 
     used by the `--regex' option.  *Note Regular Expressions:: for more
 
3217
     used by the `--regex' option.  *note Regular Expressions:: for more
3202
3218
     information on the regular expression dialects understood by GNU
3203
3219
     findutils.
3204
3220
 
3299
3315
     characters which have the eighth bit set, such as many of the
3300
3316
     characters from the ISO-8859-1 character set).  Versions of
3301
3317
     `locate' prior to 4.2.31 fail to correctly handle long filenames
3302
 
     in old-format databases.
 
3318
     in old-format databases.  Versions 4.3.0 to 4.3.6 were also
 
3319
     affected.
3303
3320
 
3304
3321
`--help'
3305
3322
     Print a summary of the command line usage and exit.
5374
5391
 
5375
5392
   In fact, since the construction
5376
5393
 
5377
 
     find ...  -print | xargs ....
 
5394
     find ...  -print | xargs ...
5378
5395
 
5379
5396
   does not cope correctly with newlines or other "white space" in file
5380
5397
names, and copes poorly with file names containing quotes, the `-print'
5442
5459
9.4.2 Long File Name Bugs with Old-Format Databases
5443
5460
---------------------------------------------------
5444
5461
 
5445
 
All versions of `locate' prior to 4.2.31 have a bug in the way that
5446
 
old-format databases are read.  They read file names into a
5447
 
fixed-length 1026 byte buffer, allocated on the heap.  This buffer is
5448
 
not extended if file names are too long to fit into the buffer.  No
5449
 
range checking on the length of the filename is performed.  This could
5450
 
in theory lead to a privilege escalation attack.  Findutils versions
5451
 
4.3.0 to 4.3.6 are also affected.
 
5462
All versions of `locate' prior to 4.2.31, and also versions 4.3.0 to
 
5463
4.3.6, have a bug in the way that old-format databases are read.  They
 
5464
read file names into a fixed-length 1026 byte buffer, allocated on the
 
5465
heap.  This buffer is not extended if file names are too long to fit
 
5466
into the buffer.  No range checking on the length of the filename is
 
5467
performed.  This could in theory lead to a privilege escalation attack.
5452
5468
 
5453
5469
   On systems using the old database format and affected versions of
5454
5470
`locate', carefully-chosen long file names could in theory allow
5494
5510
     trusted programs.
5495
5511
 
5496
5512
 
5497
 
File: find.info,  Node: Error Messages,  Next: Primary Index,  Prev: Security Considerations,  Up: Top
 
5513
File: find.info,  Node: Error Messages,  Next: GNU Free Documentation License,  Prev: Security Considerations,  Up: Top
5498
5514
 
5499
5515
10 Error Messages
5500
5516
*****************
5680
5696
<bug-findutils@gnu.org>.
5681
5697
 
5682
5698
 
5683
 
File: find.info,  Node: Primary Index,  Prev: Error Messages,  Up: Top
 
5699
File: find.info,  Node: GNU Free Documentation License,  Next: Primary Index,  Prev: Error Messages,  Up: Top
 
5700
 
 
5701
Appendix A GNU Free Documentation License
 
5702
*****************************************
 
5703
 
 
5704
                      Version 1.2, November 2002
 
5705
 
 
5706
     Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
 
5707
     51 Franklin St, Fifth Floor, Boston, MA  02110-1301, USA
 
5708
 
 
5709
     Everyone is permitted to copy and distribute verbatim copies
 
5710
     of this license document, but changing it is not allowed.
 
5711
 
 
5712
  0. PREAMBLE
 
5713
 
 
5714
     The purpose of this License is to make a manual, textbook, or other
 
5715
     functional and useful document "free" in the sense of freedom: to
 
5716
     assure everyone the effective freedom to copy and redistribute it,
 
5717
     with or without modifying it, either commercially or
 
5718
     noncommercially.  Secondarily, this License preserves for the
 
5719
     author and publisher a way to get credit for their work, while not
 
5720
     being considered responsible for modifications made by others.
 
5721
 
 
5722
     This License is a kind of "copyleft", which means that derivative
 
5723
     works of the document must themselves be free in the same sense.
 
5724
     It complements the GNU General Public License, which is a copyleft
 
5725
     license designed for free software.
 
5726
 
 
5727
     We have designed this License in order to use it for manuals for
 
5728
     free software, because free software needs free documentation: a
 
5729
     free program should come with manuals providing the same freedoms
 
5730
     that the software does.  But this License is not limited to
 
5731
     software manuals; it can be used for any textual work, regardless
 
5732
     of subject matter or whether it is published as a printed book.
 
5733
     We recommend this License principally for works whose purpose is
 
5734
     instruction or reference.
 
5735
 
 
5736
  1. APPLICABILITY AND DEFINITIONS
 
5737
 
 
5738
     This License applies to any manual or other work, in any medium,
 
5739
     that contains a notice placed by the copyright holder saying it
 
5740
     can be distributed under the terms of this License.  Such a notice
 
5741
     grants a world-wide, royalty-free license, unlimited in duration,
 
5742
     to use that work under the conditions stated herein.  The
 
5743
     "Document", below, refers to any such manual or work.  Any member
 
5744
     of the public is a licensee, and is addressed as "you".  You
 
5745
     accept the license if you copy, modify or distribute the work in a
 
5746
     way requiring permission under copyright law.
 
5747
 
 
5748
     A "Modified Version" of the Document means any work containing the
 
5749
     Document or a portion of it, either copied verbatim, or with
 
5750
     modifications and/or translated into another language.
 
5751
 
 
5752
     A "Secondary Section" is a named appendix or a front-matter section
 
5753
     of the Document that deals exclusively with the relationship of the
 
5754
     publishers or authors of the Document to the Document's overall
 
5755
     subject (or to related matters) and contains nothing that could
 
5756
     fall directly within that overall subject.  (Thus, if the Document
 
5757
     is in part a textbook of mathematics, a Secondary Section may not
 
5758
     explain any mathematics.)  The relationship could be a matter of
 
5759
     historical connection with the subject or with related matters, or
 
5760
     of legal, commercial, philosophical, ethical or political position
 
5761
     regarding them.
 
5762
 
 
5763
     The "Invariant Sections" are certain Secondary Sections whose
 
5764
     titles are designated, as being those of Invariant Sections, in
 
5765
     the notice that says that the Document is released under this
 
5766
     License.  If a section does not fit the above definition of
 
5767
     Secondary then it is not allowed to be designated as Invariant.
 
5768
     The Document may contain zero Invariant Sections.  If the Document
 
5769
     does not identify any Invariant Sections then there are none.
 
5770
 
 
5771
     The "Cover Texts" are certain short passages of text that are
 
5772
     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
 
5773
     that says that the Document is released under this License.  A
 
5774
     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
 
5775
     be at most 25 words.
 
5776
 
 
5777
     A "Transparent" copy of the Document means a machine-readable copy,
 
5778
     represented in a format whose specification is available to the
 
5779
     general public, that is suitable for revising the document
 
5780
     straightforwardly with generic text editors or (for images
 
5781
     composed of pixels) generic paint programs or (for drawings) some
 
5782
     widely available drawing editor, and that is suitable for input to
 
5783
     text formatters or for automatic translation to a variety of
 
5784
     formats suitable for input to text formatters.  A copy made in an
 
5785
     otherwise Transparent file format whose markup, or absence of
 
5786
     markup, has been arranged to thwart or discourage subsequent
 
5787
     modification by readers is not Transparent.  An image format is
 
5788
     not Transparent if used for any substantial amount of text.  A
 
5789
     copy that is not "Transparent" is called "Opaque".
 
5790
 
 
5791
     Examples of suitable formats for Transparent copies include plain
 
5792
     ASCII without markup, Texinfo input format, LaTeX input format,
 
5793
     SGML or XML using a publicly available DTD, and
 
5794
     standard-conforming simple HTML, PostScript or PDF designed for
 
5795
     human modification.  Examples of transparent image formats include
 
5796
     PNG, XCF and JPG.  Opaque formats include proprietary formats that
 
5797
     can be read and edited only by proprietary word processors, SGML or
 
5798
     XML for which the DTD and/or processing tools are not generally
 
5799
     available, and the machine-generated HTML, PostScript or PDF
 
5800
     produced by some word processors for output purposes only.
 
5801
 
 
5802
     The "Title Page" means, for a printed book, the title page itself,
 
5803
     plus such following pages as are needed to hold, legibly, the
 
5804
     material this License requires to appear in the title page.  For
 
5805
     works in formats which do not have any title page as such, "Title
 
5806
     Page" means the text near the most prominent appearance of the
 
5807
     work's title, preceding the beginning of the body of the text.
 
5808
 
 
5809
     A section "Entitled XYZ" means a named subunit of the Document
 
5810
     whose title either is precisely XYZ or contains XYZ in parentheses
 
5811
     following text that translates XYZ in another language.  (Here XYZ
 
5812
     stands for a specific section name mentioned below, such as
 
5813
     "Acknowledgements", "Dedications", "Endorsements", or "History".)
 
5814
     To "Preserve the Title" of such a section when you modify the
 
5815
     Document means that it remains a section "Entitled XYZ" according
 
5816
     to this definition.
 
5817
 
 
5818
     The Document may include Warranty Disclaimers next to the notice
 
5819
     which states that this License applies to the Document.  These
 
5820
     Warranty Disclaimers are considered to be included by reference in
 
5821
     this License, but only as regards disclaiming warranties: any other
 
5822
     implication that these Warranty Disclaimers may have is void and
 
5823
     has no effect on the meaning of this License.
 
5824
 
 
5825
  2. VERBATIM COPYING
 
5826
 
 
5827
     You may copy and distribute the Document in any medium, either
 
5828
     commercially or noncommercially, provided that this License, the
 
5829
     copyright notices, and the license notice saying this License
 
5830
     applies to the Document are reproduced in all copies, and that you
 
5831
     add no other conditions whatsoever to those of this License.  You
 
5832
     may not use technical measures to obstruct or control the reading
 
5833
     or further copying of the copies you make or distribute.  However,
 
5834
     you may accept compensation in exchange for copies.  If you
 
5835
     distribute a large enough number of copies you must also follow
 
5836
     the conditions in section 3.
 
5837
 
 
5838
     You may also lend copies, under the same conditions stated above,
 
5839
     and you may publicly display copies.
 
5840
 
 
5841
  3. COPYING IN QUANTITY
 
5842
 
 
5843
     If you publish printed copies (or copies in media that commonly
 
5844
     have printed covers) of the Document, numbering more than 100, and
 
5845
     the Document's license notice requires Cover Texts, you must
 
5846
     enclose the copies in covers that carry, clearly and legibly, all
 
5847
     these Cover Texts: Front-Cover Texts on the front cover, and
 
5848
     Back-Cover Texts on the back cover.  Both covers must also clearly
 
5849
     and legibly identify you as the publisher of these copies.  The
 
5850
     front cover must present the full title with all words of the
 
5851
     title equally prominent and visible.  You may add other material
 
5852
     on the covers in addition.  Copying with changes limited to the
 
5853
     covers, as long as they preserve the title of the Document and
 
5854
     satisfy these conditions, can be treated as verbatim copying in
 
5855
     other respects.
 
5856
 
 
5857
     If the required texts for either cover are too voluminous to fit
 
5858
     legibly, you should put the first ones listed (as many as fit
 
5859
     reasonably) on the actual cover, and continue the rest onto
 
5860
     adjacent pages.
 
5861
 
 
5862
     If you publish or distribute Opaque copies of the Document
 
5863
     numbering more than 100, you must either include a
 
5864
     machine-readable Transparent copy along with each Opaque copy, or
 
5865
     state in or with each Opaque copy a computer-network location from
 
5866
     which the general network-using public has access to download
 
5867
     using public-standard network protocols a complete Transparent
 
5868
     copy of the Document, free of added material.  If you use the
 
5869
     latter option, you must take reasonably prudent steps, when you
 
5870
     begin distribution of Opaque copies in quantity, to ensure that
 
5871
     this Transparent copy will remain thus accessible at the stated
 
5872
     location until at least one year after the last time you
 
5873
     distribute an Opaque copy (directly or through your agents or
 
5874
     retailers) of that edition to the public.
 
5875
 
 
5876
     It is requested, but not required, that you contact the authors of
 
5877
     the Document well before redistributing any large number of
 
5878
     copies, to give them a chance to provide you with an updated
 
5879
     version of the Document.
 
5880
 
 
5881
  4. MODIFICATIONS
 
5882
 
 
5883
     You may copy and distribute a Modified Version of the Document
 
5884
     under the conditions of sections 2 and 3 above, provided that you
 
5885
     release the Modified Version under precisely this License, with
 
5886
     the Modified Version filling the role of the Document, thus
 
5887
     licensing distribution and modification of the Modified Version to
 
5888
     whoever possesses a copy of it.  In addition, you must do these
 
5889
     things in the Modified Version:
 
5890
 
 
5891
       A. Use in the Title Page (and on the covers, if any) a title
 
5892
          distinct from that of the Document, and from those of
 
5893
          previous versions (which should, if there were any, be listed
 
5894
          in the History section of the Document).  You may use the
 
5895
          same title as a previous version if the original publisher of
 
5896
          that version gives permission.
 
5897
 
 
5898
       B. List on the Title Page, as authors, one or more persons or
 
5899
          entities responsible for authorship of the modifications in
 
5900
          the Modified Version, together with at least five of the
 
5901
          principal authors of the Document (all of its principal
 
5902
          authors, if it has fewer than five), unless they release you
 
5903
          from this requirement.
 
5904
 
 
5905
       C. State on the Title page the name of the publisher of the
 
5906
          Modified Version, as the publisher.
 
5907
 
 
5908
       D. Preserve all the copyright notices of the Document.
 
5909
 
 
5910
       E. Add an appropriate copyright notice for your modifications
 
5911
          adjacent to the other copyright notices.
 
5912
 
 
5913
       F. Include, immediately after the copyright notices, a license
 
5914
          notice giving the public permission to use the Modified
 
5915
          Version under the terms of this License, in the form shown in
 
5916
          the Addendum below.
 
5917
 
 
5918
       G. Preserve in that license notice the full lists of Invariant
 
5919
          Sections and required Cover Texts given in the Document's
 
5920
          license notice.
 
5921
 
 
5922
       H. Include an unaltered copy of this License.
 
5923
 
 
5924
       I. Preserve the section Entitled "History", Preserve its Title,
 
5925
          and add to it an item stating at least the title, year, new
 
5926
          authors, and publisher of the Modified Version as given on
 
5927
          the Title Page.  If there is no section Entitled "History" in
 
5928
          the Document, create one stating the title, year, authors,
 
5929
          and publisher of the Document as given on its Title Page,
 
5930
          then add an item describing the Modified Version as stated in
 
5931
          the previous sentence.
 
5932
 
 
5933
       J. Preserve the network location, if any, given in the Document
 
5934
          for public access to a Transparent copy of the Document, and
 
5935
          likewise the network locations given in the Document for
 
5936
          previous versions it was based on.  These may be placed in
 
5937
          the "History" section.  You may omit a network location for a
 
5938
          work that was published at least four years before the
 
5939
          Document itself, or if the original publisher of the version
 
5940
          it refers to gives permission.
 
5941
 
 
5942
       K. For any section Entitled "Acknowledgements" or "Dedications",
 
5943
          Preserve the Title of the section, and preserve in the
 
5944
          section all the substance and tone of each of the contributor
 
5945
          acknowledgements and/or dedications given therein.
 
5946
 
 
5947
       L. Preserve all the Invariant Sections of the Document,
 
5948
          unaltered in their text and in their titles.  Section numbers
 
5949
          or the equivalent are not considered part of the section
 
5950
          titles.
 
5951
 
 
5952
       M. Delete any section Entitled "Endorsements".  Such a section
 
5953
          may not be included in the Modified Version.
 
5954
 
 
5955
       N. Do not retitle any existing section to be Entitled
 
5956
          "Endorsements" or to conflict in title with any Invariant
 
5957
          Section.
 
5958
 
 
5959
       O. Preserve any Warranty Disclaimers.
 
5960
 
 
5961
     If the Modified Version includes new front-matter sections or
 
5962
     appendices that qualify as Secondary Sections and contain no
 
5963
     material copied from the Document, you may at your option
 
5964
     designate some or all of these sections as invariant.  To do this,
 
5965
     add their titles to the list of Invariant Sections in the Modified
 
5966
     Version's license notice.  These titles must be distinct from any
 
5967
     other section titles.
 
5968
 
 
5969
     You may add a section Entitled "Endorsements", provided it contains
 
5970
     nothing but endorsements of your Modified Version by various
 
5971
     parties--for example, statements of peer review or that the text
 
5972
     has been approved by an organization as the authoritative
 
5973
     definition of a standard.
 
5974
 
 
5975
     You may add a passage of up to five words as a Front-Cover Text,
 
5976
     and a passage of up to 25 words as a Back-Cover Text, to the end
 
5977
     of the list of Cover Texts in the Modified Version.  Only one
 
5978
     passage of Front-Cover Text and one of Back-Cover Text may be
 
5979
     added by (or through arrangements made by) any one entity.  If the
 
5980
     Document already includes a cover text for the same cover,
 
5981
     previously added by you or by arrangement made by the same entity
 
5982
     you are acting on behalf of, you may not add another; but you may
 
5983
     replace the old one, on explicit permission from the previous
 
5984
     publisher that added the old one.
 
5985
 
 
5986
     The author(s) and publisher(s) of the Document do not by this
 
5987
     License give permission to use their names for publicity for or to
 
5988
     assert or imply endorsement of any Modified Version.
 
5989
 
 
5990
  5. COMBINING DOCUMENTS
 
5991
 
 
5992
     You may combine the Document with other documents released under
 
5993
     this License, under the terms defined in section 4 above for
 
5994
     modified versions, provided that you include in the combination
 
5995
     all of the Invariant Sections of all of the original documents,
 
5996
     unmodified, and list them all as Invariant Sections of your
 
5997
     combined work in its license notice, and that you preserve all
 
5998
     their Warranty Disclaimers.
 
5999
 
 
6000
     The combined work need only contain one copy of this License, and
 
6001
     multiple identical Invariant Sections may be replaced with a single
 
6002
     copy.  If there are multiple Invariant Sections with the same name
 
6003
     but different contents, make the title of each such section unique
 
6004
     by adding at the end of it, in parentheses, the name of the
 
6005
     original author or publisher of that section if known, or else a
 
6006
     unique number.  Make the same adjustment to the section titles in
 
6007
     the list of Invariant Sections in the license notice of the
 
6008
     combined work.
 
6009
 
 
6010
     In the combination, you must combine any sections Entitled
 
6011
     "History" in the various original documents, forming one section
 
6012
     Entitled "History"; likewise combine any sections Entitled
 
6013
     "Acknowledgements", and any sections Entitled "Dedications".  You
 
6014
     must delete all sections Entitled "Endorsements."
 
6015
 
 
6016
  6. COLLECTIONS OF DOCUMENTS
 
6017
 
 
6018
     You may make a collection consisting of the Document and other
 
6019
     documents released under this License, and replace the individual
 
6020
     copies of this License in the various documents with a single copy
 
6021
     that is included in the collection, provided that you follow the
 
6022
     rules of this License for verbatim copying of each of the
 
6023
     documents in all other respects.
 
6024
 
 
6025
     You may extract a single document from such a collection, and
 
6026
     distribute it individually under this License, provided you insert
 
6027
     a copy of this License into the extracted document, and follow
 
6028
     this License in all other respects regarding verbatim copying of
 
6029
     that document.
 
6030
 
 
6031
  7. AGGREGATION WITH INDEPENDENT WORKS
 
6032
 
 
6033
     A compilation of the Document or its derivatives with other
 
6034
     separate and independent documents or works, in or on a volume of
 
6035
     a storage or distribution medium, is called an "aggregate" if the
 
6036
     copyright resulting from the compilation is not used to limit the
 
6037
     legal rights of the compilation's users beyond what the individual
 
6038
     works permit.  When the Document is included in an aggregate, this
 
6039
     License does not apply to the other works in the aggregate which
 
6040
     are not themselves derivative works of the Document.
 
6041
 
 
6042
     If the Cover Text requirement of section 3 is applicable to these
 
6043
     copies of the Document, then if the Document is less than one half
 
6044
     of the entire aggregate, the Document's Cover Texts may be placed
 
6045
     on covers that bracket the Document within the aggregate, or the
 
6046
     electronic equivalent of covers if the Document is in electronic
 
6047
     form.  Otherwise they must appear on printed covers that bracket
 
6048
     the whole aggregate.
 
6049
 
 
6050
  8. TRANSLATION
 
6051
 
 
6052
     Translation is considered a kind of modification, so you may
 
6053
     distribute translations of the Document under the terms of section
 
6054
     4.  Replacing Invariant Sections with translations requires special
 
6055
     permission from their copyright holders, but you may include
 
6056
     translations of some or all Invariant Sections in addition to the
 
6057
     original versions of these Invariant Sections.  You may include a
 
6058
     translation of this License, and all the license notices in the
 
6059
     Document, and any Warranty Disclaimers, provided that you also
 
6060
     include the original English version of this License and the
 
6061
     original versions of those notices and disclaimers.  In case of a
 
6062
     disagreement between the translation and the original version of
 
6063
     this License or a notice or disclaimer, the original version will
 
6064
     prevail.
 
6065
 
 
6066
     If a section in the Document is Entitled "Acknowledgements",
 
6067
     "Dedications", or "History", the requirement (section 4) to
 
6068
     Preserve its Title (section 1) will typically require changing the
 
6069
     actual title.
 
6070
 
 
6071
  9. TERMINATION
 
6072
 
 
6073
     You may not copy, modify, sublicense, or distribute the Document
 
6074
     except as expressly provided for under this License.  Any other
 
6075
     attempt to copy, modify, sublicense or distribute the Document is
 
6076
     void, and will automatically terminate your rights under this
 
6077
     License.  However, parties who have received copies, or rights,
 
6078
     from you under this License will not have their licenses
 
6079
     terminated so long as such parties remain in full compliance.
 
6080
 
 
6081
 10. FUTURE REVISIONS OF THIS LICENSE
 
6082
 
 
6083
     The Free Software Foundation may publish new, revised versions of
 
6084
     the GNU Free Documentation License from time to time.  Such new
 
6085
     versions will be similar in spirit to the present version, but may
 
6086
     differ in detail to address new problems or concerns.  See
 
6087
     `http://www.gnu.org/copyleft/'.
 
6088
 
 
6089
     Each version of the License is given a distinguishing version
 
6090
     number.  If the Document specifies that a particular numbered
 
6091
     version of this License "or any later version" applies to it, you
 
6092
     have the option of following the terms and conditions either of
 
6093
     that specified version or of any later version that has been
 
6094
     published (not as a draft) by the Free Software Foundation.  If
 
6095
     the Document does not specify a version number of this License,
 
6096
     you may choose any version ever published (not as a draft) by the
 
6097
     Free Software Foundation.
 
6098
 
 
6099
ADDENDUM: How to use this License for your documents
 
6100
====================================================
 
6101
 
 
6102
To use this License in a document you have written, include a copy of
 
6103
the License in the document and put the following copyright and license
 
6104
notices just after the title page:
 
6105
 
 
6106
       Copyright (C)  YEAR  YOUR NAME.
 
6107
       Permission is granted to copy, distribute and/or modify this document
 
6108
       under the terms of the GNU Free Documentation License, Version 1.2
 
6109
       or any later version published by the Free Software Foundation;
 
6110
       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
 
6111
       Texts.  A copy of the license is included in the section entitled ``GNU
 
6112
       Free Documentation License''.
 
6113
 
 
6114
   If you have Invariant Sections, Front-Cover Texts and Back-Cover
 
6115
Texts, replace the "with...Texts." line with this:
 
6116
 
 
6117
         with the Invariant Sections being LIST THEIR TITLES, with
 
6118
         the Front-Cover Texts being LIST, and with the Back-Cover Texts
 
6119
         being LIST.
 
6120
 
 
6121
   If you have Invariant Sections without Cover Texts, or some other
 
6122
combination of the three, merge those two alternatives to suit the
 
6123
situation.
 
6124
 
 
6125
   If your document contains nontrivial examples of program code, we
 
6126
recommend releasing these examples in parallel under your choice of
 
6127
free software license, such as the GNU General Public License, to
 
6128
permit their use in free software.
 
6129
 
 
6130
 
 
6131
File: find.info,  Node: Primary Index,  Prev: GNU Free Documentation License,  Up: Top
5684
6132
 
5685
6133
`find' Primary Index
5686
6134
********************
5731
6179
* -fstype:                               Filesystems.         (line  22)
5732
6180
* -gid:                                  Owner.               (line  13)
5733
6181
* -group:                                Owner.               (line   8)
5734
 
* -ignore_readdir_race:                  Directories.         (line  86)
 
6182
* -ignore_readdir_race:                  Directories.         (line  88)
5735
6183
* -ilname:                               Symbolic Links.      (line  87)
5736
6184
* -iname:                                Base Name Patterns.  (line   8)
5737
6185
* -inum:                                 Hard Links.          (line  41)
5751
6199
* -newer:                                Comparing Timestamps.
5752
6200
                                                              (line  19)
5753
6201
* -nogroup:                              Owner.               (line  18)
5754
 
* -noignore_readdir_race:                Directories.         (line 103)
5755
 
* -noleaf:                               Directories.         (line  71)
 
6202
* -noignore_readdir_race:                Directories.         (line 105)
 
6203
* -noleaf:                               Directories.         (line  73)
5756
6204
* -not:                                  Combining Primaries With Operators.
5757
6205
                                                              (line  14)
5758
6206
* -nouser:                               Owner.               (line  17)
5789
6237
 
5790
6238
 
5791
6239
Tag Table:
5792
 
Node: Top1523
5793
 
Node: Introduction2568
5794
 
Node: Scope4864
5795
 
Node: Overview6789
5796
 
Node: find Expressions8660
5797
 
Node: Finding Files10285
5798
 
Node: Name10752
5799
 
Node: Base Name Patterns11380
5800
 
Ref: Base Name Patterns-Footnote-112478
5801
 
Node: Full Name Patterns12690
5802
 
Node: Fast Full Name Search15353
5803
 
Node: Shell Pattern Matching17774
5804
 
Node: Links19864
5805
 
Node: Symbolic Links20299
5806
 
Node: Hard Links24796
5807
 
Node: Time27350
5808
 
Node: Age Ranges27938
5809
 
Node: Comparing Timestamps29465
5810
 
Node: Size30757
5811
 
Node: Type32599
5812
 
Node: Owner34267
5813
 
Node: Permissions35094
5814
 
Node: Contents38255
5815
 
Node: Directories39428
5816
 
Node: Filesystems44389
5817
 
Node: Combining Primaries With Operators45740
5818
 
Node: Actions47358
5819
 
Node: Print File Name47920
5820
 
Node: Print File Information48937
5821
 
Node: Escapes51932
5822
 
Node: Format Directives52683
5823
 
Node: Name Directives54146
5824
 
Node: Ownership Directives55132
5825
 
Node: Size Directives56149
5826
 
Node: Location Directives56915
5827
 
Node: Time Directives58034
5828
 
Node: Time Formats58937
5829
 
Node: Time Components59373
5830
 
Node: Date Components59879
5831
 
Node: Combined Time Formats60702
5832
 
Node: Formatting Flags61419
5833
 
Node: Run Commands62031
5834
 
Node: Single File62389
5835
 
Node: Multiple Files64311
5836
 
Node: Unsafe File Name Handling68847
5837
 
Node: Safe File Name Handling70410
5838
 
Node: Unusual Characters in File Names71986
5839
 
Node: Limiting Command Size75022
5840
 
Node: Interspersing File Names77315
5841
 
Node: Querying79770
5842
 
Node: Delete Files81300
5843
 
Node: Adding Tests81704
5844
 
Node: Databases84344
5845
 
Node: Database Locations85062
5846
 
Node: Database Formats86070
5847
 
Node: New Database Format86974
5848
 
Node: Sample Database88641
5849
 
Node: Old Database Format89289
5850
 
Node: Newline Handling91591
5851
 
Node: File Permissions93037
5852
 
Node: Mode Structure93606
5853
 
Node: Symbolic Modes96747
5854
 
Node: Setting Permissions97844
5855
 
Node: Copying Permissions100392
5856
 
Node: Changing Special Permissions101206
5857
 
Node: Conditional Executability102750
5858
 
Node: Multiple Changes103282
5859
 
Node: Umask and Protection104939
5860
 
Node: Numeric Modes106037
5861
 
Node: Reference107729
5862
 
Node: Invoking find108077
5863
 
Node: Warning Messages110409
5864
 
Node: Invoking locate112097
5865
 
Node: Invoking updatedb117988
5866
 
Node: Invoking xargs121784
5867
 
Node: Regular Expressions126814
5868
 
Node: findutils-default regular expression syntax128009
5869
 
Node: awk regular expression syntax130514
5870
 
Node: egrep regular expression syntax132399
5871
 
Node: emacs regular expression syntax134610
5872
 
Node: gnu-awk regular expression syntax137138
5873
 
Node: grep regular expression syntax139478
5874
 
Node: posix-awk regular expression syntax142203
5875
 
Node: posix-basic regular expression syntax144474
5876
 
Node: posix-egrep regular expression syntax147112
5877
 
Node: posix-extended regular expression syntax149485
5878
 
Node: Environment Variables151960
5879
 
Node: Common Tasks153904
5880
 
Node: Viewing And Editing154329
5881
 
Node: Archiving155335
5882
 
Node: Cleaning Up156967
5883
 
Node: Strange File Names158756
5884
 
Node: Fixing Permissions160406
5885
 
Node: Classifying Files160970
5886
 
Node: Worked Examples161688
5887
 
Node: Deleting Files162325
5888
 
Node: Updating A Timestamp File175344
5889
 
Node: Security Considerations182074
5890
 
Node: Levels of Risk183608
5891
 
Ref: Levels of Risk-Footnote-1186406
5892
 
Node: Security Considerations for find186585
5893
 
Ref: Security Considerations for find-Footnote-1188907
5894
 
Node: Problems with -exec and filenames188980
5895
 
Node: Changing the Current Working Directory190243
5896
 
Node: O_NOFOLLOW192012
5897
 
Ref: O_NOFOLLOW-Footnote-1193656
5898
 
Node: Systems without O_NOFOLLOW193758
5899
 
Node: Race Conditions with -exec195862
5900
 
Node: Race Conditions with -print and -print0198773
5901
 
Node: Security Considerations for xargs199693
5902
 
Node: Security Considerations for locate201763
5903
 
Node: Security Summary203954
5904
 
Node: Error Messages204711
5905
 
Node: Error Messages From find205723
5906
 
Node: Error Messages From xargs210580
5907
 
Node: Error Messages From locate212340
5908
 
Node: Error Messages From updatedb213572
5909
 
Node: Primary Index213975
 
6240
Node: Top1259
 
6241
Node: Introduction3021
 
6242
Node: Scope5317
 
6243
Node: Overview7242
 
6244
Node: find Expressions9113
 
6245
Node: Finding Files10738
 
6246
Node: Name11205
 
6247
Node: Base Name Patterns11833
 
6248
Ref: Base Name Patterns-Footnote-112931
 
6249
Node: Full Name Patterns13143
 
6250
Node: Fast Full Name Search15806
 
6251
Node: Shell Pattern Matching18227
 
6252
Node: Links20317
 
6253
Node: Symbolic Links20752
 
6254
Node: Hard Links25249
 
6255
Node: Time27803
 
6256
Node: Age Ranges28391
 
6257
Node: Comparing Timestamps29918
 
6258
Node: Size31210
 
6259
Node: Type33052
 
6260
Node: Owner34720
 
6261
Node: Permissions35547
 
6262
Node: Contents38708
 
6263
Node: Directories39881
 
6264
Node: Filesystems45002
 
6265
Node: Combining Primaries With Operators46353
 
6266
Node: Actions47971
 
6267
Node: Print File Name48533
 
6268
Node: Print File Information49550
 
6269
Node: Escapes52545
 
6270
Node: Format Directives53296
 
6271
Node: Name Directives54759
 
6272
Node: Ownership Directives55745
 
6273
Node: Size Directives56762
 
6274
Node: Location Directives57527
 
6275
Node: Time Directives58646
 
6276
Node: Time Formats59549
 
6277
Node: Time Components59985
 
6278
Node: Date Components60491
 
6279
Node: Combined Time Formats61314
 
6280
Node: Formatting Flags62031
 
6281
Node: Run Commands62643
 
6282
Node: Single File63001
 
6283
Node: Multiple Files64923
 
6284
Node: Unsafe File Name Handling69459
 
6285
Node: Safe File Name Handling71022
 
6286
Node: Unusual Characters in File Names72598
 
6287
Node: Limiting Command Size75634
 
6288
Node: Interspersing File Names77927
 
6289
Node: Querying80382
 
6290
Node: Delete Files81912
 
6291
Node: Adding Tests82316
 
6292
Node: Databases84956
 
6293
Node: Database Locations85674
 
6294
Node: Database Formats86682
 
6295
Node: New Database Format87586
 
6296
Node: Sample Database89253
 
6297
Node: Old Database Format89901
 
6298
Node: Newline Handling92187
 
6299
Node: File Permissions93633
 
6300
Node: Mode Structure94202
 
6301
Node: Symbolic Modes97343
 
6302
Node: Setting Permissions98440
 
6303
Node: Copying Permissions100988
 
6304
Node: Changing Special Permissions101802
 
6305
Node: Conditional Executability103346
 
6306
Node: Multiple Changes103878
 
6307
Node: Umask and Protection105535
 
6308
Node: Numeric Modes106633
 
6309
Node: Reference108325
 
6310
Node: Invoking find108673
 
6311
Node: Warning Messages111005
 
6312
Node: Invoking locate112941
 
6313
Node: Invoking updatedb118832
 
6314
Node: Invoking xargs122678
 
6315
Node: Regular Expressions127708
 
6316
Node: findutils-default regular expression syntax128903
 
6317
Node: awk regular expression syntax131408
 
6318
Node: egrep regular expression syntax133293
 
6319
Node: emacs regular expression syntax135504
 
6320
Node: gnu-awk regular expression syntax138032
 
6321
Node: grep regular expression syntax140372
 
6322
Node: posix-awk regular expression syntax143097
 
6323
Node: posix-basic regular expression syntax145368
 
6324
Node: posix-egrep regular expression syntax148006
 
6325
Node: posix-extended regular expression syntax150379
 
6326
Node: Environment Variables152854
 
6327
Node: Common Tasks154798
 
6328
Node: Viewing And Editing155223
 
6329
Node: Archiving156229
 
6330
Node: Cleaning Up157861
 
6331
Node: Strange File Names159650
 
6332
Node: Fixing Permissions161300
 
6333
Node: Classifying Files161864
 
6334
Node: Worked Examples162582
 
6335
Node: Deleting Files163219
 
6336
Node: Updating A Timestamp File176238
 
6337
Node: Security Considerations182968
 
6338
Node: Levels of Risk184502
 
6339
Ref: Levels of Risk-Footnote-1187300
 
6340
Node: Security Considerations for find187479
 
6341
Ref: Security Considerations for find-Footnote-1189801
 
6342
Node: Problems with -exec and filenames189874
 
6343
Node: Changing the Current Working Directory191137
 
6344
Node: O_NOFOLLOW192906
 
6345
Ref: O_NOFOLLOW-Footnote-1194550
 
6346
Node: Systems without O_NOFOLLOW194652
 
6347
Node: Race Conditions with -exec196756
 
6348
Node: Race Conditions with -print and -print0199667
 
6349
Node: Security Considerations for xargs200586
 
6350
Node: Security Considerations for locate202656
 
6351
Node: Security Summary204828
 
6352
Node: Error Messages205585
 
6353
Node: Error Messages From find206614
 
6354
Node: Error Messages From xargs211471
 
6355
Node: Error Messages From locate213231
 
6356
Node: Error Messages From updatedb214463
 
6357
Node: GNU Free Documentation License214866
 
6358
Node: Primary Index237305
5910
6359
 
5911
6360
End Tag Table