usr/src/man/man1/paste.1

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1992, X/Open Company Limited  All Rights Reserved  Portions Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
   4 .\" http://www.opengroup.org/bookstore/.
   5 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
   6 .\"  This notice shall appear on any product containing this material.
   7 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   9 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
  10 .TH PASTE 1 "Dec 20, 1996"
  11 .SH NAME
  12 paste \- merge corresponding or subsequent lines of files
  13 .SH SYNOPSIS
  14 .LP
  15 .nf
  16 \fBpaste\fR [\fB-s\fR] [\fB-d\fR \fIlist\fR] \fIfile\fR...
  17 .fi
  18
  19 .SH DESCRIPTION
  20 .sp
  21 .LP
  22 The \fBpaste\fR utility will concatenate the corresponding lines of the given
  23 input files, and write the resulting lines to standard output.
  24 .sp
  25 .LP
  26 The default operation of \fBpaste\fR will concatenate the corresponding lines
  27 of the input files. The \fBNEWLINE\fR character of every line except the line
  28 from the last input file will be replaced with a \fBTAB\fR character.
  29 .sp
  30 .LP
  31 If an \fBEOF\fR (end-of-file) condition is detected on one or more input files,
  32 but not all input files, \fBpaste\fR will behave as though empty lines were
  33 read from the files on which \fBEOF\fR was detected, unless the \fB-s\fR option
  34 is specified.
  35 .SH OPTIONS
  36 .sp
  37 .LP
  38 The following options are supported:
  39 .sp
  40 .ne 2
  41 .na
  42 \fB\fB-d\fR \fIlist\fR \fR
  43 .ad
  44 .RS 12n
  45 Unless a backslash character (\|\e\|) appears in \fIlist\fR, each character in
  46 \fIlist\fR is an element specifying a delimiter character. If a backslash
  47 character appears in \fIlist\fR, the backslash character and one or more
  48 characters following it are an element specifying a delimiter character as
  49 described below. These elements specify one or more delimiters to use, instead
  50 of the default \fBTAB\fR character, to replace the \fBNEWLINE\fR character of
  51 the input lines. The elements in \fIlist\fR are used circularly. That is, when
  52 the list is exhausted, the first element from the list is reused.
  53 .sp
  54 When the \fB-s\fR option is specified:
  55 .RS +4
  56 .TP
  57 .ie t \(bu
  58 .el o
  59 The last newline character in a file will not be modified.
  60 .RE
  61 .RS +4
  62 .TP
  63 .ie t \(bu
  64 .el o
  65 The delimiter will be reset to the first element of list after each \fIfile\fR
  66 operand is processed.
  67 .RE
  68 When the option is not specified:
  69 .RS +4
  70 .TP
  71 .ie t \(bu
  72 .el o
  73 The \fBNEWLINE\fR characters in the file specified by the last \fIfile\fR will
  74 not be modified.
  75 .RE
  76 .RS +4
  77 .TP
  78 .ie t \(bu
  79 .el o
  80 The delimiter will be reset to the first element of \fIlist\fR each time a line
  81 is processed from each file.
  82 .RE
  83 If a backslash character appears in \fIlist\fR, it and the character following
  84 it will be used to represent the following delimiter characters:
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fB\en\fR \fR
  89 .ad
  90 .RS 9n
  91 Newline character.
  92 .RE
  93
  94 .sp
  95 .ne 2
  96 .na
  97 \fB\fB\et\fR \fR
  98 .ad
  99 .RS 9n
 100 Tab character.
 101 .RE
 102
 103 .sp
 104 .ne 2
 105 .na
 106 \fB\fB\e\e\fR \fR
 107 .ad
 108 .RS 9n
 109 Backslash character.
 110 .RE
 111
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fB\e0\fR \fR
 116 .ad
 117 .RS 9n
 118 Empty string (not a null character). If \fB\e0\fR is immediately followed by
 119 the character \fBx\fR, the character \fBX\fR, or any character defined by the
 120 \fBLC_CTYPE\fR \fBdigit\fR keyword, the results are unspecified.
 121 .RE
 122
 123 If any other characters follow the backslash, the results are unspecified.
 124 .RE
 125
 126 .sp
 127 .ne 2
 128 .na
 129 \fB\fB-s\fR \fR
 130 .ad
 131 .RS 12n
 132 Concatenate all of the lines of each separate input file in command line order.
 133 The \fBNEWLINE\fR character of every line except the last line in each input
 134 file will be replaced with the \fBTAB\fR character, unless otherwise specified
 135 by the \fB-d\fR option.
 136 .RE
 137
 138 .SH OPERANDS
 139 .sp
 140 .LP
 141 The following operand is supported:
 142 .sp
 143 .ne 2
 144 .na
 145 \fB\fIfile\fR \fR
 146 .ad
 147 .RS 9n
 148 A path name of an input file. If \fB\(mi\fR is specified for one or more of the
 149 \fIfile\fRs, the standard input will be used. The standard input will be read
 150 one line at a time, circularly, for each instance of \fB\(mi\fR\&.
 151 Implementations support pasting of at least 12 \fIfile\fR operands.
 152 .RE
 153
 154 .SH USAGE
 155 .sp
 156 .LP
 157 See \fBlargefile\fR(5) for the description of the behavior of \fBpaste\fR when
 158 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
 159 .SH EXAMPLES
 160 .LP
 161 \fBExample 1 \fRListing a directory in one column
 162 .sp
 163 .in +2
 164 .nf
 165 example% \fBls | paste -d" " \(mi\fR
 166 .fi
 167 .in -2
 168 .sp
 169
 170 .LP
 171 \fBExample 2 \fRListing a directory in four columns
 172 .sp
 173 .in +2
 174 .nf
 175 example% \fBls | paste \(mi \(mi \(mi \(mi\fR
 176 .fi
 177 .in -2
 178 .sp
 179
 180 .LP
 181 \fBExample 3 \fRCombining pairs of lines from a file into single lines
 182 .sp
 183 .in +2
 184 .nf
 185 example% \fBpaste -s -d"\e t\e n" file\fR
 186 .fi
 187 .in -2
 188 .sp
 189
 190 .SH ENVIRONMENT VARIABLES
 191 .sp
 192 .LP
 193 See \fBenviron\fR(5) for descriptions of the following environment variables
 194 that affect the execution of \fBpaste\fR: \fBLANG\fR, \fBLC_ALL\fR,
 195 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
 196 .SH EXIT STATUS
 197 .sp
 198 .LP
 199 The following exit values are returned:
 200 .sp
 201 .ne 2
 202 .na
 203 \fB\fB0\fR \fR
 204 .ad
 205 .RS 7n
 206 Successful completion.
 207 .RE
 208
 209 .sp
 210 .ne 2
 211 .na
 212 \fB\fB>0\fR \fR
 213 .ad
 214 .RS 7n
 215 An error occurred.
 216 .RE
 217
 218 .SH ATTRIBUTES
 219 .sp
 220 .LP
 221 See \fBattributes\fR(5) for descriptions of the following attributes:
 222 .sp
 223
 224 .sp
 225 .TS
 226 box;
 227 c | c
 228 l | l .
 229 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 230 _
 231 CSI     Enabled
 232 _
 233 Interface Stability     Standard
 234 .TE
 235
 236 .SH SEE ALSO
 237 .sp
 238 .LP
 239 \fBcut\fR(1), \fBgrep\fR(1), \fBpr\fR(1), \fBattributes\fR(5),
 240 \fBenviron\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5)
 241 .SH DIAGNOSTICS
 242 .sp
 243 .ne 2
 244 .na
 245 \fB\fB"line too long"\fR\fR
 246 .ad
 247 .RS 22n
 248 Output lines are restricted to 511 characters.
 249 .RE
 250
 251 .sp
 252 .ne 2
 253 .na
 254 \fB\fB"too many files"\fR\fR
 255 .ad
 256 .RS 22n
 257 Except for \fB-s\fR option, no more than 12 input files may be specified.
 258 .RE
 259
 260 .sp
 261 .ne 2
 262 .na
 263 \fB\fB"no delimiters"\fR\fR
 264 .ad
 265 .RS 22n
 266 The \fB-d\fR option was specified with an empty list.
 267 .RE
 268
 269 .sp
 270 .ne 2
 271 .na
 272 \fB\fB"cannot open \fR\fBfile\fR\fB"\fR\fR
 273 .ad
 274 .RS 22n
 275 The specified file cannot be opened.
 276 .RE
 277