{ "content": [ { "type": "text", "text": "# namei (man)\n\n## NAME\n\nnamei - follow a pathname until a terminal point is found\n\n## SYNOPSIS\n\nnamei [options] pathname...\n\n## DESCRIPTION\n\nnamei interprets its arguments as pathnames to any type of Unix file (symlinks, files,\ndirectories, and so forth). namei then follows each pathname until an endpoint is found (a\nfile, a directory, a device node, etc). If it finds a symbolic link, it shows the link, and\nstarts following it, indenting the output to show the context.\n\n## TLDR\n\n> Follows a pathname (which can be a symbolic link) until a terminal point is found (a file/directory/char device etc).\n\n- Resolve the pathnames specified as the argument parameters:\n `namei {{path/to/a}} {{path/to/b}} {{path/to/c}}`\n- Display the results in a long-listing format:\n `namei {{-l|--long}} {{path/to/a}} {{path/to/b}} {{path/to/c}}`\n- Show the mode bits of each file type in the style of `ls`:\n `namei {{-m|--modes}} {{path/to/a}} {{path/to/b}} {{path/to/c}}`\n- Show owner and group name of each file:\n `namei {{-o|--owners}} {{path/to/a}} {{path/to/b}} {{path/to/c}}`\n- Don't follow symlinks while resolving:\n `namei {{-n|--nosymlinks}} {{path/to/a}} {{path/to/b}} {{path/to/c}}`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (8 subsections)\n- **BUGS**\n- **AUTHORS**\n- **SEE ALSO**\n- **REPORTING BUGS**\n- **AVAILABILITY**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "namei", "section": "", "mode": "man", "summary": "namei - follow a pathname until a terminal point is found", "synopsis": "namei [options] pathname...", "tldr_summary": "Follows a pathname (which can be a symbolic link) until a terminal point is found (a file/directory/char device etc).", "tldr_examples": [ { "description": "Resolve the pathnames specified as the argument parameters", "command": "namei {{path/to/a}} {{path/to/b}} {{path/to/c}}" }, { "description": "Display the results in a long-listing format", "command": "namei {{-l|--long}} {{path/to/a}} {{path/to/b}} {{path/to/c}}" }, { "description": "Show the mode bits of each file type in the style of `ls`", "command": "namei {{-m|--modes}} {{path/to/a}} {{path/to/b}} {{path/to/c}}" }, { "description": "Show owner and group name of each file", "command": "namei {{-o|--owners}} {{path/to/a}} {{path/to/b}} {{path/to/c}}" }, { "description": "Don't follow symlinks while resolving", "command": "namei {{-n|--nosymlinks}} {{path/to/a}} {{path/to/b}} {{path/to/c}}" } ], "tldr_source": "official", "flags": [ { "flag": "-l", "long": "--long", "arg": null, "description": "Use the long listing format (same as -m -o -v)." }, { "flag": "-m", "long": "--modes", "arg": null, "description": "Show the mode bits of each file type in the style of ls(1), for example 'rwxr-xr-x'." }, { "flag": "-n", "long": "--nosymlinks", "arg": null, "description": "Don’t follow symlinks." }, { "flag": "-o", "long": "--owners", "arg": null, "description": "Show owner and group name of each file." }, { "flag": "-v", "long": "--vertical", "arg": null, "description": "Vertically align the modes and owners." }, { "flag": "-x", "long": "--mountpoints", "arg": null, "description": "Show mountpoint directories with a 'D' rather than a 'd'." }, { "flag": "-V", "long": "--version", "arg": null, "description": "Display version information and exit." }, { "flag": "-h", "long": "--help", "arg": null, "description": "Display help text and exit." } ], "examples": [], "see_also": [ { "name": "ls", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/ls/1/json" }, { "name": "stat", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/stat/1/json" }, { "name": "symlink", "section": "7", "url": "https://www.chedong.com/phpMan.php/man/symlink/7/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 22, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-l --long", "lines": 2, "flag": "-l", "long": "--long" }, { "name": "-m --modes", "lines": 2, "flag": "-m", "long": "--modes" }, { "name": "-n --nosymlinks", "lines": 2, "flag": "-n", "long": "--nosymlinks" }, { "name": "-o --owners", "lines": 2, "flag": "-o", "long": "--owners" }, { "name": "-v --vertical", "lines": 2, "flag": "-v", "long": "--vertical" }, { "name": "-x --mountpoints", "lines": 2, "flag": "-x", "long": "--mountpoints" }, { "name": "-V --version", "lines": 2, "flag": "-V", "long": "--version" }, { "name": "-h --help", "lines": 2, "flag": "-h", "long": "--help" } ] }, { "name": "BUGS", "lines": 2, "subsections": [] }, { "name": "AUTHORS", "lines": 4, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "REPORTING BUGS", "lines": 2, "subsections": [] }, { "name": "AVAILABILITY", "lines": 6, "subsections": [] } ], "sections": { "NAME": { "content": "namei - follow a pathname until a terminal point is found\n", "subsections": [] }, "SYNOPSIS": { "content": "namei [options] pathname...\n", "subsections": [] }, "DESCRIPTION": { "content": "namei interprets its arguments as pathnames to any type of Unix file (symlinks, files,\ndirectories, and so forth). namei then follows each pathname until an endpoint is found (a\nfile, a directory, a device node, etc). If it finds a symbolic link, it shows the link, and\nstarts following it, indenting the output to show the context.\n\nThis program is useful for finding \"too many levels of symbolic links\" problems.\n\nFor each line of output, namei uses the following characters to identify the file type found:\n\nf: = the pathname currently being resolved\nd = directory\nl = symbolic link (both the link and its contents are output)\ns = socket\nb = block device\nc = character device\np = FIFO (named pipe)\n- = regular file\n? = an error of some kind\n\nnamei prints an informative message when the maximum number of symbolic links this system can\nhave has been exceeded.\n", "subsections": [] }, "OPTIONS": { "content": "", "subsections": [ { "name": "-l --long", "content": "Use the long listing format (same as -m -o -v).\n", "flag": "-l", "long": "--long" }, { "name": "-m --modes", "content": "Show the mode bits of each file type in the style of ls(1), for example 'rwxr-xr-x'.\n", "flag": "-m", "long": "--modes" }, { "name": "-n --nosymlinks", "content": "Don’t follow symlinks.\n", "flag": "-n", "long": "--nosymlinks" }, { "name": "-o --owners", "content": "Show owner and group name of each file.\n", "flag": "-o", "long": "--owners" }, { "name": "-v --vertical", "content": "Vertically align the modes and owners.\n", "flag": "-v", "long": "--vertical" }, { "name": "-x --mountpoints", "content": "Show mountpoint directories with a 'D' rather than a 'd'.\n", "flag": "-x", "long": "--mountpoints" }, { "name": "-V --version", "content": "Display version information and exit.\n", "flag": "-V", "long": "--version" }, { "name": "-h --help", "content": "Display help text and exit.\n", "flag": "-h", "long": "--help" } ] }, "BUGS": { "content": "To be discovered.\n", "subsections": [] }, "AUTHORS": { "content": "The original namei program was written by Roger Southwick .\n\nThe program was rewritten by Karel Zak Karel Zak .\n", "subsections": [] }, "SEE ALSO": { "content": "ls(1), stat(1), symlink(7)\n", "subsections": [] }, "REPORTING BUGS": { "content": "For bug reports, use the issue tracker at https://github.com/karelzak/util-linux/issues.\n", "subsections": [] }, "AVAILABILITY": { "content": "The namei command is part of the util-linux package which can be downloaded from Linux Kernel\nArchive .\n\n\n\nutil-linux 2.37.2 2021-06-02 NAMEI(1)", "subsections": [] } } } }