Debian Codegraph @

upstream/opensuse-tumbleweed/man1/cut.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH CUT "1" "May 2026" "GNU coreutils 9.11" "User Commands"
3 .SH NAME
4 cut \- remove sections from each line of files
5 .SH SYNOPSIS
6 .B cut
7 \fI\,OPTION\/\fR... [\fI\,FILE\/\fR]...
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 .PP
11 Print selected parts of lines from each FILE to standard output.
12 .PP
13 With no FILE, or when FILE is \-, read standard input.
14 .PP
15 Mandatory arguments to long options are mandatory for short options too.
16 .TP
17 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-b'\fB\-b, \-\-bytes=\,LIST\fP\X'tty: link'\/\fR
18 select only these byte positions
19 .TP
20 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-c'\fB\-c, \-\-characters=\,LIST\fP\X'tty: link'\/\fR
21 select only these character positions
22 .TP
23 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut--complement'\fB\-\-complement\fP\X'tty: link'
24 complement the set of selected bytes, characters or fields
25 .TP
26 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-d'\fB\-d, \-\-delimiter=\,DELIM\fP\X'tty: link'\/\fR
27 use DELIM instead of TAB for field delimiter
28 .TP
29 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-f'\fB\-f, \-\-fields=\,LIST\fP\X'tty: link'\/\fR
30 select only these fields; also print any line that contains
31 no delimiter character, unless the \fB\-s\fR option is specified
32 .TP
33 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-F'\fB\-F LIST\fP\X'tty: link'
34 like \fB\-f\fR, but also implies \fB\-w\fR and \fB\-O\fR ' '
35 .TP
36 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-n'\fB\-n, \-\-no\-partial\fP\X'tty: link'
37 with \fB\-b\fR, don't output partial multi\-byte characters
38 .TP
39 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-O'\fB\-O, \-\-output\-delimiter=\,STRING\fP\X'tty: link'\/\fR
40 use STRING as the output delimiter;
41 the default is to use the input delimiter
42 .TP
43 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-s'\fB\-s, \-\-only\-delimited\fP\X'tty: link'
44 do not print lines not containing delimiters
45 .TP
46 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-w'\fB\-w, \-\-whitespace\-delimited[=\,trimmed]\fP\X'tty: link'\/\fR
47 use a run of blank characters as the field delimiter;
48 with 'trimmed', ignore leading and trailing blanks
49 .TP
50 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#cut-z'\fB\-z, \-\-zero\-terminated\fP\X'tty: link'
51 line delimiter is NUL, not newline
52 .TP
53 \X'tty: link https://www.gnu.org/software/coreutils/cut#cut--help'\fB\-\-help\fP\X'tty: link'
54 display this help and exit
55 .TP
56 \X'tty: link https://www.gnu.org/software/coreutils/cut#cut--version'\fB\-\-version\fP\X'tty: link'
57 output version information and exit
58 .PP
59 Use one, and only one of \fB\-b\fR, \fB\-c\fR, \fB\-f\fR or \fB\-F\fR. Each LIST is made up of one
60 range, or many ranges separated by commas. Selected input is written
61 in the same order that it is read, and is written exactly once.
62 Each range is one of:
63 .TP
64 N
65 N'th byte, character or field, counted from 1
66 .TP
67 N\-
68 from N'th byte, character or field, to end of line
69 .TP
70 N\-M
71 from N'th to M'th (included) byte, character or field
72 .TP
73 \fB\-M\fR
74 from first to M'th (included) byte, character or field
75 .SH AUTHOR
76 Written by David M. Ihnat, David MacKenzie, and Jim Meyering.
77 .SH "REPORTING BUGS"
78 Report bugs to: bug\[email protected]
79 .br
80 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
81 .br
82 General help using GNU software: <https://www.gnu.org/gethelp/>
83 .br
84 Report any translation bugs to <https://translationproject.org/team/>
85 .SH COPYRIGHT
86 Copyright \(co 2026 Free Software Foundation, Inc.
87 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
88 .br
89 This is free software: you are free to change and redistribute it.
90 There is NO WARRANTY, to the extent permitted by law.
91 .SH "SEE ALSO"
92 Full documentation <https://www.gnu.org/software/coreutils/cut>
93 .br
94 or available locally via: info \(aq(coreutils) cut invocation\(aq