fd/doc/fd.1

127 lines
2.2 KiB
Groff
Raw Normal View History

2017-10-17 15:50:55 +02:00
.TH FD 1 fd-4.0.0
.SH NAME
fd \- find files
.BR find (1)
.SH SYNOPSIS
.B fd
2017-10-17 15:50:55 +02:00
.RB [ \-HIsaLp0hV ]
.RB [ \- d
.IR depth ]
.RB [ \-t
.IR filetype ]
.RB [ \-e
.IR ext ]
.RB [ \-c
.IR when ]
.RB [ \-j
.IR num ]
.RB [ \-x
.IR exec ]
2017-10-17 15:50:55 +02:00
.RI [ pattern ]
.RI [ path ]
.SH DESCRIPTION
.B fd
is a simple, fast and user-friendly alternative to
.BR find (1).
.SH OPTIONS
.TP
.B \-H, \-\-hidden
Search hidden files and directories.
.TP
.B \-I, \-\-no\-ignore
2017-10-17 15:50:55 +02:00
Do not respect any
.BR gitignore (5)
files.
.TP
.B \-s, \-\-case\-sensitive
2017-10-17 15:50:55 +02:00
Perform a case-sensitive search (default: smart case).
.TP
.B \-a, \-\-absolute\-path
Show absolute instead of relative paths.
.TP
.B \-L, \-\-follow
Dereference all symbolic links encountered.
.TP
.B \-p, \-\-full\-path
Match
.I pattern
against full
.IR path .
2017-10-17 15:50:55 +02:00
.TP
.B \-0, \-\-print0
Print results followed by null character instead of newlines.
2017-10-17 15:50:55 +02:00
.TP
.B \-h, \-\-help
Prints help information.
.TP
.B \-V, \-\-version
2017-10-17 15:50:55 +02:00
Prints version information.
.TP
.BI "\-d, \-\-max\-depth " levels
Limit directory traversal to at most
.I levels
of depth.
.TP
.BI "\-t, \-\-type " c
Filter search by type:
.RS
.IP "f, file"
regular files
.IP "d, directories"
directories
.IP "s, symlink"
symbolic links
.RE
.TP
.BI "\-e, \-\-extension " ext
Filter search results by file extension
.IR ext .
.TP
.BI "\-c, \-\-color " when
Declare
.I when
to colorize search results:
2017-10-17 15:50:55 +02:00
.RS
.IP auto
Colorize output when standard output is connected to terminal. (default)
2017-10-17 15:50:55 +02:00
.IP never
Do not colorize output.
2017-10-17 15:50:55 +02:00
.IP always
Always colorize output.
2017-10-17 15:50:55 +02:00
.RE
.TP
.BI "\-j, \-\-threads " num
Number of threads to use for searching. (default: number of processing units
available)
.TP
.BI "\-x, \-\-exec " command
Execute
.I command
on each of the discovered path with the following tokens substituted:
.RS
.IP {}
path
.IP {.}
path without extension
.IP {/}
basename of path
.IP {//}
parent of path
.IP {/.}
basename of path without extension
.RE
2017-10-17 15:50:55 +02:00
.SH ENVIRONMENT
.TP
.B LS_COLORS
Determines how to colorize search results, see
.BR dircolors (1) .
2017-10-17 15:50:55 +02:00
.SH EXAMPLES
.TP
.RI "Find the specific log files in " /var/log .
$ fd nginx /var/log
2017-10-17 15:50:55 +02:00
.TP
Find all Python files that ends with \(dq.py\(dq in the current directory.
$ fd -e py
.SH SEE ALSO
.BR find (1)