| blob | 290bdceb8b7393dc06d131a10497c982a3fce794 |
1 .\" $NetBSD: jot.1,v 1.9 2008/02/24 00:05:31 dsl Exp $
2 .\"
3 .\" Copyright (c) 1993
4 .\" The Regents of the University of California. All rights reserved.
5 .\"
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
8 .\" are met:
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\" 3. Neither the name of the University nor the names of its contributors
15 .\" may be used to endorse or promote products derived from this software
16 .\" without specific prior written permission.
17 .\"
18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" SUCH DAMAGE.
29 .\"
30 .\" @(#)jot.1 8.1 (Berkeley) 6/6/93
31 .\"
32 .Dd February 24, 2008
33 .Dt JOT 1
34 .Os
35 .Sh NAME
36 .Nm jot
37 .Nd print sequential or random data
38 .Sh SYNOPSIS
39 .Nm
40 .Op Fl cnr
41 .Bk -words
42 .Op Fl b Ar word
43 .Ek
44 .Bk -words
45 .Op Fl p Ar precision
46 .Ek
47 .Bk -words
48 .Op Fl s Ar string
49 .Ek
50 .Bk -words
51 .Op Fl w Ar word
52 .Ek
53 .Oo Ar reps
54 .Oo Ar begin
55 .Oo Ar end
56 .Op Ar s
57 .Oc
58 .Oc
59 .Oc
60 .Sh DESCRIPTION
61 The
62 .Nm jot
63 utility is used to print out increasing, decreasing, random,
64 or redundant data (usually numbers) one per line.
65 .Pp
66 The following options are available:
67 .Bl -tag -width indent
68 .It Fl b Ar word
69 Just print
70 .Ar word
71 repetitively.
72 .It Fl c
73 This is an abbreviation for
74 .Fl w Ar %c .
75 .It Fl n
76 Do not print the final newline normally appended to the output.
77 .It Fl p Ar precision
78 Print only as many digits or characters of the data
79 as indicated by the integer
80 .Ar precision .
81 In the absence of
82 .Fl p ,
83 the precision is the greater of the precisions of
84 .Ar begin
85 and
86 .Ar end .
87 The
88 .Fl p
89 option is overridden by whatever appears in a
90 .Xr printf 3
91 conversion following
92 .Fl w .
93 .It Fl r
94 Generate random data instead of sequential data, the default.
95 .It Fl s Ar string
96 Print data separated by
97 .Ar string .
98 Normally, newlines separate data.
99 .It Fl w Ar word
100 Print
101 .Ar word
102 with the generated data appended to it.
103 Octal, hexadecimal, exponential, ASCII, zero padded,
104 and right-adjusted representations
105 are possible by using the appropriate
106 .Xr printf 3
107 conversion specification inside
108 .Ar word ,
109 in which case the data are inserted rather than appended.
110 .El
111 .Pp
112 The last four arguments indicate, respectively,
113 the number of data, the lower bound, the upper bound,
114 and the step size or, for random data, the seed.
115 While at least one of them must appear,
116 any of the other three may be omitted, and
117 will be considered as such if given as
118 .Dq - .
119 Any three of these arguments determines the fourth.
120 If four are specified and the given and computed values of
121 .Ar reps
122 conflict, the lower value is used.
123 If fewer than three are specified, defaults are assigned
124 left to right, except for
125 .Ar s ,
126 which assumes its default unless both
127 .Ar begin
128 and
129 .Ar end
130 are given.
131 .Pp
132 Defaults for the four arguments are, respectively,
133 100, 1, 100, and 1, except that when random data are requested,
134 .Ar s
135 defaults to a seed depending upon the time of day.
136 .Ar reps
137 is expected to be an unsigned integer,
138 and if given as zero is taken to be infinite.
139 .Ar begin
140 and
141 .Ar end
142 may be given as real numbers or as characters
143 representing the corresponding value in ASCII.
144 The last argument must be a real number.
145 .Pp
146 Random numbers are obtained through
147 .Xr random 3 .
148 The name
149 .Nm jot
150 derives in part from
151 .Nm iota ,
152 a function in APL.
153 .Sh EXAMPLES
154 The command:
155 .Dl "jot 21 \-1 1.00"
156 prints 21 evenly spaced numbers increasing from \-1 to 1.
157 .Pp
158 The command:
159 .Dl "jot \-c 128 0"
160 prints the ASCII character set.
161 .Pp
162 The command:
163 .Dl "jot \-w xa%c 26 a"
164 prints the strings
165 .Dq xaa
166 through
167 .Dq xaz .
168 .Pp
169 The command:
170 .Dl "jot \-r \-c 160 a z | rs \-g 0 8"
171 prints 20 random 8-letter strings.
172 .Pp
173 The command:
174 .Dl "jot \-b y 0"
175 is equivalent to
176 .Xr yes 1 .
177 .Pp
178 The command:
179 .Dl "jot \-w %ds/old/new/ 30 2 \- 5"
180 prints thirty
181 .Xr ed 1
182 substitution commands applying to lines 2, 7, 12, etc.
183 .Pp
184 The command:
185 .Dl "jot 0 9 \- \-.5"
186 prints the stuttering sequence 9, 8, 8, 7, etc.
187 .Pp
188 The command:
189 .Dl "jot \-b x 512 \*[Gt] block"
190 creates a file containing exactly 1024 bytes.
191 .Pp
192 The command:
193 .Dl "expand \-\`jot \-s, \- 10 132 4\`"
194 sets tabs four spaces apart starting
195 from column 10 and ending in column 132.
196 .Pp
197 The command:
198 .Dl "grep \`jot \-s """" \-b . 80\`"
199 prints all lines 80 characters or longer.
200 .Sh SEE ALSO
201 .Xr ed 1 ,
202 .Xr expand 1 ,
203 .Xr rs 1 ,
204 .Xr yes 1 ,
205 .Xr printf 3 ,
206 .Xr random 3