{
    "content": [
        {
            "type": "text",
            "text": "# find (info)\n\n## Sections\n\n- **File: find.info,  Node: Invoking find,  Next: Invoking locate,  Up: Reference** (1 subsections)\n- **File: find.info,  Node: Filesystem Traversal Options,  Next: Warning Messages,  Up: Invoking find**\n- **The options '-H', '-L' or '-P' may be specified at the start of the**\n- **File: find.info,  Node: Warning Messages,  Next: Optimisation Options,  Prev: Filesystem Traversal Options,  Up: Invoking find**\n- **If there is an error on the 'find' command line, an error message is**\n- **File: find.info,  Node: Optimisation Options,  Next: Debug Options,  Prev: Warning Messages,  Up: Invoking find**\n- **The '-OLEVEL' option sets 'find''s optimisation level to LEVEL.  The**\n- **File: find.info,  Node: Debug Options,  Next: Find Expressions,  Prev: Optimisation Options,  Up: Invoking find**\n- **The '-D' option makes 'find' produce diagnostic output.  Much of the**\n- **For a complete list of valid debug options, see the output of 'find -D**\n- **File: find.info,  Node: Find Expressions,  Prev: Debug Options,  Up: Invoking find**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "find",
        "section": "",
        "mode": "info",
        "summary": null,
        "synopsis": null,
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "File: find.info,  Node: Invoking find,  Next: Invoking locate,  Up: Reference",
                "lines": 1,
                "subsections": [
                    {
                        "name": "8.1 Invoking 'find'",
                        "lines": 39
                    }
                ]
            },
            {
                "name": "File: find.info,  Node: Filesystem Traversal Options,  Next: Warning Messages,  Up: Invoking find",
                "lines": 1,
                "subsections": []
            },
            {
                "name": "The options '-H', '-L' or '-P' may be specified at the start of the",
                "lines": 20,
                "subsections": []
            },
            {
                "name": "File: find.info,  Node: Warning Messages,  Next: Optimisation Options,  Prev: Filesystem Traversal Options,  Up: Invoking find",
                "lines": 1,
                "subsections": []
            },
            {
                "name": "If there is an error on the 'find' command line, an error message is",
                "lines": 38,
                "subsections": []
            },
            {
                "name": "File: find.info,  Node: Optimisation Options,  Next: Debug Options,  Prev: Warning Messages,  Up: Invoking find",
                "lines": 1,
                "subsections": []
            },
            {
                "name": "The '-OLEVEL' option sets 'find''s optimisation level to LEVEL.  The",
                "lines": 38,
                "subsections": []
            },
            {
                "name": "File: find.info,  Node: Debug Options,  Next: Find Expressions,  Prev: Optimisation Options,  Up: Invoking find",
                "lines": 1,
                "subsections": []
            },
            {
                "name": "The '-D' option makes 'find' produce diagnostic output.  Much of the",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "For a complete list of valid debug options, see the output of 'find -D",
                "lines": 19,
                "subsections": []
            },
            {
                "name": "File: find.info,  Node: Find Expressions,  Prev: Debug Options,  Up: Invoking find",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "File: find.info,  Node: Invoking find,  Next: Invoking locate,  Up: Reference": {
                "content": "",
                "subsections": [
                    {
                        "name": "8.1 Invoking 'find'",
                        "content": "find [-H] [-L] [-P] [-D DEBUGOPTIONS] [-OLEVEL] [FILE...] [EXPRESSION]\n\n'find' searches the directory tree rooted at each file name FILE by\nevaluating the EXPRESSION on each file it finds in the tree.\n\nThe command line may begin with the '-H', '-L', '-P', '-D' and '-O'\noptions.  These are followed by a list of files or directories that\nshould be searched.  If no files to search are specified, the current\ndirectory ('.') is used.\n\nThis list of files to search is followed by a list of expressions\ndescribing the files we wish to search for.  The first part of the\nexpression is recognised by the fact that it begins with '-' followed by\nsome other letters (for example '-print'), or is either '(' or '!'.  Any\narguments after it are the rest of the expression.\n\nIf no expression is given, the expression '-print' is used.\n\nThe 'find' command exits with status zero if all files matched are\nprocessed successfully, greater than zero if errors occur.\n\nThe 'find' program also recognises two options for administrative\nuse:\n\n'--help'\nPrint a summary of the command line usage and exit.\n'--version'\nPrint the version number of 'find' and exit.\n\nThe '-version' option is a synonym for '--version'\n\n* Menu:\n\n* Filesystem Traversal Options::\n* Warning Messages::\n* Optimisation Options::\n* Debug Options::\n* Find Expressions::\n"
                    }
                ]
            },
            "File: find.info,  Node: Filesystem Traversal Options,  Next: Warning Messages,  Up: Invoking find": {
                "content": "",
                "subsections": []
            },
            "The options '-H', '-L' or '-P' may be specified at the start of the": {
                "content": "command line (if none of these is specified, '-P' is assumed).  If you\nspecify more than one of these options, the last one specified takes\neffect (but note that the '-follow' option is equivalent to '-L').\n\n'-P'\nNever follow symbolic links (this is the default), except in the\ncase of the '-xtype' predicate.\n'-L'\nAlways follow symbolic links, except in the case of the '-xtype'\npredicate.\n'-H'\nFollow symbolic links specified in the list of files to search, or\nwhich are otherwise specified on the command line.\n\nIf 'find' would follow a symbolic link, but cannot for any reason\n(for example, because it has insufficient permissions or the link is\nbroken), it falls back on using the properties of the symbolic link\nitself.  *note Symbolic Links:: for a more complete description of how\nsymbolic links are handled.\n",
                "subsections": []
            },
            "File: find.info,  Node: Warning Messages,  Next: Optimisation Options,  Prev: Filesystem Traversal Options,  Up: Invoking find": {
                "content": "",
                "subsections": []
            },
            "If there is an error on the 'find' command line, an error message is": {
                "content": "normally issued.  However, there are some usages that are inadvisable\nbut which 'find' should still accept.  Under these circumstances, 'find'\nmay issue a warning message.\n\nBy default, warnings are enabled only if 'find' is being run\ninteractively (specifically, if the standard input is a terminal) and\nthe 'POSIXLYCORRECT' environment variable is not set.  Warning messages\ncan be controlled explicitly by the use of options on the command line:\n\n'-warn'\nIssue warning messages where appropriate.\n'-nowarn'\nDo not issue warning messages.\n\nThese options take effect at the point on the command line where they\nare specified.  Therefore it's not useful to specify '-nowarn' at the\nend of the command line.  The warning messages affected by the above\noptions are triggered by:\n\n- Use of the '-d' option which is deprecated; please use '-depth'\ninstead, since the latter is POSIX-compliant.\n- Specifying an option (for example '-mindepth') after a non-option\n(for example '-type' or '-print') on the command line.\n- Use of the '-name' or '-iname' option with a slash character in the\npattern.  Since the name predicates only compare against the\nbasename of the visited files, the only file that can match a slash\nis the root directory itself.\n\nThe default behaviour above is designed to work in that way so that\nexisting shell scripts don't generate spurious errors, but people will\nbe made aware of the problem.\n\nSome warning messages are issued for less common or more serious\nproblems, and consequently cannot be turned off:\n\n- Use of an unrecognised backslash escape sequence with '-fprintf'\n- Use of an unrecognised formatting directive with '-fprintf'\n",
                "subsections": []
            },
            "File: find.info,  Node: Optimisation Options,  Next: Debug Options,  Prev: Warning Messages,  Up: Invoking find": {
                "content": "",
                "subsections": []
            },
            "The '-OLEVEL' option sets 'find''s optimisation level to LEVEL.  The": {
                "content": "default optimisation level is 1.\n\nAt certain optimisation levels, 'find' reorders tests to speed up\nexecution while preserving the overall effect; that is, predicates with\nside effects are not reordered relative to each other.  The\noptimisations performed at each optimisation level are as follows.\n\n'0'\nCurrently equivalent to optimisation level 1.\n\n'1'\nThis is the default optimisation level and corresponds to the\ntraditional behaviour.  Expressions are reordered so that tests\nbased only on the names of files (for example' -name' and '-regex')\nare performed first.\n\n'2'\nAny '-type' or '-xtype' tests are performed after any tests based\nonly on the names of files, but before any tests that require\ninformation from the inode.  On many modern versions of Unix, file\ntypes are returned by 'readdir()' and so these predicates are\nfaster to evaluate than predicates which need to stat the file\nfirst.\n\nIf you use the '-fstype FOO' predicate and specify a filsystem type\n'FOO' which is not known (that is, present in '/etc/mtab') at the\ntime 'find' starts, that predicate is equivalent to '-false'.\n\n'3'\nAt this optimisation level, the full cost-based query optimiser is\nenabled.  The order of tests is modified so that cheap (i.e., fast)\ntests are performed first and more expensive ones are performed\nlater, if necessary.  Within each cost band, predicates are\nevaluated earlier or later according to whether they are likely to\nsucceed or not.  For '-o', predicates which are likely to succeed\nare evaluated earlier, and for '-a', predicates which are likely to\nfail are evaluated earlier.\n",
                "subsections": []
            },
            "File: find.info,  Node: Debug Options,  Next: Find Expressions,  Prev: Optimisation Options,  Up: Invoking find": {
                "content": "",
                "subsections": []
            },
            "The '-D' option makes 'find' produce diagnostic output.  Much of the": {
                "content": "information is useful only for diagnosing problems, and so most people\nwill not find this option helpful.\n\nThe list of debug options should be comma separated.  Compatibility\nof the debug options is not guaranteed between releases of findutils.",
                "subsections": []
            },
            "For a complete list of valid debug options, see the output of 'find -D": {
                "content": "help'.\n\nValid debug options include:\n'tree'\nShow the expression tree in its original and optimised form.\n'stat'\nPrint messages as files are examined with the stat and lstat system\ncalls.  The find program tries to minimise such calls.\n'opt'\nPrints diagnostic information relating to the optimisation of the\nexpression tree; see the '-O' option.\n'rates'\nPrints a summary indicating how often each predicate succeeded or\nfailed.\n'all'\nEnable all of the other debug options (but 'help').\n'help'\nExplain the debugging options.\n",
                "subsections": []
            },
            "File: find.info,  Node: Find Expressions,  Prev: Debug Options,  Up: Invoking find": {
                "content": "The final part of the 'find' command line is a list of expressions.\n*Note Primary Index::, for a summary of all of the tests, actions, and\noptions that the expression can contain.  If the expression is missing,\n'-print' is assumed.\n",
                "subsections": []
            }
        }
    }
}