1FD(1)                       General Commands Manual                      FD(1)
2
3
4

NAME

6       fd - find entries in the filesystem
7

SYNOPSIS

9       fd  [-HIEsiaLp0hV]  [-d  depth] [-t filetype] [-e ext] [-E exclude] [-c
10       when] [-j num] [-x cmd] [pattern] [path...]
11

DESCRIPTION

13       fd is a simple, fast and user-friendly alternative to find(1).
14

OPTIONS

16       -H, --hidden
17              Include hidden files and directories in the search results.
18
19       -I, --no-ignore
20              Do not respect files like .gitignore and .fdignore  and  include
21              ignored files in the search results.
22
23       --no-ignore-vcs
24              Do  not respect version control ignore files like .gitignore and
25              include the respective entries in the search results.
26
27       -s, --case-sensitive
28              Perform a case-sensitive search (default: smart case).
29
30       -i, --ignore-case
31              Perform a case-insensitive search (default: smart case).
32
33       -F, --fixed-strings
34              Treat the pattern as a  literal  string  instead  of  a  regular
35              expression.
36
37       -a, --absolute-path
38              Show absolute instead of relative paths.
39
40       -L, --follow
41              Dereference all symbolic links encountered.
42
43       -p, --full-path
44              Match the pattern against the full path instead of just the file
45              or directory name.
46
47       -0, --print0
48              Separate search results by null characters instead of newlines.
49
50       -h, --help
51              Print help information.
52
53       -V, --version
54              Print version information.
55
56       -d, --max-depth d
57              Limit directory traversal to at  most  d  levels  of  depth.  By
58              default, there is no limit on the search depth.
59
60       -t, --type filetype
61              Filter search by type:
62
63              f, file
64                     regular files
65
66              d, directories
67                     directories
68
69              l, symlink
70                     symbolic links
71
72              x, executable
73                     executable (files)
74
75              This  option  can  be used repeatedly to allow for multiple file
76              types.
77
78       -e, --extension ext
79              Filter search results by file extension ext.  This option can be
80              used repeatedly to allow for multiple possible file extensions.
81
82       -E, --exclude pattern
83              Exclude  files/directories  that  match  the given glob pattern.
84              This overrides any other ignore logic.   Multiple  exclude  pat‐
85              terns can be specified.
86
87       --ignore-file path
88              Add  a  custom  ignore-file in '.gitignore' format.  These files
89              have a low precedence.
90
91       -c, --color when
92              Declare when to colorize search results:
93
94              auto   Colorize output when standard output is connected to ter‐
95                     minal (default).
96
97              never  Do not colorize output.
98
99              always Always colorize output.
100
101       -j, --threads num
102              Number  of  threads  to  use  for  searching (default: number of
103              available CPUs).
104
105       -x, --exec command [args...] ;
106              Execute command for each search result. The following placehold‐
107              ers  are  substituted  by a path derived from the current search
108              result:
109
110              {}     path
111
112              {/}    basename
113
114              {//}   parent directory
115
116              {.}    path without file extension
117
118              {/.}   basename without file extension
119

ENVIRONMENT

121       LS_COLORS
122              Determines how to colorize search results, see dircolors(1).
123

EXAMPLES

125       Find files and directories that match the pattern 'needle':
126              $ fd needle
127
128       Start a search in a given directory (/var/log):
129              $ fd nginx /var/log
130
131       Find all Python files (all files with the extention .py) in the current
132       directory:
133              $ fd -e py
134

SEE ALSO

136       find(1)
137
138
139
140                                                                         FD(1)