Annotation of src/usr.bin/cut/cut.1, Revision 1.22
1.22 ! jmc 1: .\" $OpenBSD: cut.1,v 1.21 2014/02/01 23:34:49 sobrado Exp $
1.1 deraadt 2: .\" $NetBSD: cut.1,v 1.6 1995/10/02 20:19:26 jtc Exp $
3: .\"
4: .\" Copyright (c) 1989, 1990, 1993
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" This code is derived from software contributed to Berkeley by
8: .\" the Institute of Electrical and Electronics Engineers, Inc.
9: .\"
10: .\" Redistribution and use in source and binary forms, with or without
11: .\" modification, are permitted provided that the following conditions
12: .\" are met:
13: .\" 1. Redistributions of source code must retain the above copyright
14: .\" notice, this list of conditions and the following disclaimer.
15: .\" 2. Redistributions in binary form must reproduce the above copyright
16: .\" notice, this list of conditions and the following disclaimer in the
17: .\" documentation and/or other materials provided with the distribution.
1.8 millert 18: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 19: .\" may be used to endorse or promote products derived from this software
20: .\" without specific prior written permission.
21: .\"
22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32: .\" SUCH DAMAGE.
33: .\"
34: .\" @(#)cut.1 8.1 (Berkeley) 6/6/93
35: .\"
1.21 sobrado 36: .Dd $Mdocdate: February 1 2014 $
1.1 deraadt 37: .Dt CUT 1
38: .Os
39: .Sh NAME
40: .Nm cut
41: .Nd select portions of each line of a file
42: .Sh SYNOPSIS
43: .Nm cut
44: .Fl b Ar list
45: .Op Fl n
46: .Op Ar
47: .Nm cut
48: .Fl c Ar list
49: .Op Ar
50: .Nm cut
51: .Fl f Ar list
1.13 sobrado 52: .Op Fl s
1.1 deraadt 53: .Op Fl d Ar delim
54: .Op Ar
55: .Sh DESCRIPTION
56: The
1.5 aaron 57: .Nm
1.1 deraadt 58: utility selects portions of each line (as specified by
1.6 aaron 59: .Ar list )
1.1 deraadt 60: from each
61: .Ar file
1.21 sobrado 62: and writes them to the standard output.
63: If no
64: .Ar file
65: arguments are specified, or a file argument is a single dash
66: .Pq Sq \- ,
67: .Nm
68: reads from the standard input.
1.1 deraadt 69: The items specified by
70: .Ar list
71: can be in terms of column position or in terms of fields delimited
1.6 aaron 72: by a special character.
1.19 jmc 73: Column and field numbering starts from 1.
1.1 deraadt 74: .Pp
1.3 aaron 75: .Ar list
1.16 schwarze 76: is a comma or whitespace separated set of numbers and/or
1.1 deraadt 77: number ranges.
78: Number ranges consist of a number, a dash
1.3 aaron 79: .Pq Sq \- ,
1.1 deraadt 80: and a second number
1.6 aaron 81: which select the fields or columns from the first number to the second,
1.1 deraadt 82: inclusive.
83: Numbers or number ranges may be preceded by a dash, which selects all
84: fields or columns from 1 to the first number.
85: Numbers or number ranges may be followed by a dash, which selects all
86: fields or columns from the last number to the end of the line.
87: Numbers and number ranges may be repeated, overlapping, and in any order.
88: It is not an error to select fields or columns not present in the
89: input line.
90: .Pp
91: The options are as follows:
1.7 aaron 92: .Bl -tag -width Ds
1.1 deraadt 93: .It Fl b Ar list
1.4 aaron 94: The
1.1 deraadt 95: .Ar list
96: specifies byte positions.
97: .It Fl c Ar list
98: The
99: .Ar list
100: specifies character positions.
1.10 jmc 101: .It Fl d Ar delim
1.1 deraadt 102: Use the first character of
1.10 jmc 103: .Ar delim
1.14 jmc 104: as the field delimiter character.
105: The default is the
106: .Aq TAB
107: character.
1.1 deraadt 108: .It Fl f Ar list
109: The
110: .Ar list
1.14 jmc 111: specifies fields, separated by the field delimiter character.
112: The selected fields are output,
113: separated by the field delimiter character.
1.1 deraadt 114: .It Fl n
115: Do not split multi-byte characters.
116: .It Fl s
117: Suppresses lines with no field delimiter characters.
118: Unless specified, lines with no delimiters are passed through unmodified.
119: .El
1.17 jmc 120: .Sh EXIT STATUS
1.22 ! jmc 121: The
! 122: .Nm
! 123: utility exits 0 if all input files are output successfully,
! 124: and >0 if an error occurs.
1.9 jmc 125: .Sh EXAMPLES
126: Extract login names and shells from the system
127: .Xr passwd 5
128: file as
129: .Dq name:shell
130: pairs:
131: .Pp
132: .Dl "$ cut -d : -f 1,7 /etc/passwd"
133: .Pp
134: Show the names and login times of logged in users:
135: .Pp
1.20 sobrado 136: .Dl "$ who | cut -c 1-8,18-30"
1.1 deraadt 137: .Sh SEE ALSO
138: .Xr paste 1
139: .Sh STANDARDS
140: The
1.5 aaron 141: .Nm
1.11 jmc 142: utility is compliant with the
1.15 jmc 143: .St -p1003.1-2008
1.11 jmc 144: specification.
1.16 schwarze 145: .Sh CAVEATS
146: The current implementation does not support multi-byte characters.
147: Consequently
148: .Fl c
149: does the same as
150: .Fl b ,
151: and
152: .Fl n
153: has no effect.