summaryrefslogtreecommitdiff
path: root/isascii.1
blob: 9a3f51de2bb6e4ea3647c497172edb0c670c6c04 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
.\" isacii.1 - manual page for the isascii command
.\" Copyright (C) 2008  Lars Wirzenius
.\"
.\" This program is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.\"
.TH ISASCII 1
.SH NAME
isascii \- verify that input files consist of ASCII characters only
.SH SYNOPSIS
.BR isascii " [" "-hq" "] [" --help "] [" --quiet "]"
.IR file ...
.SH DESCRIPTION
.B isascii
reads through one or more files, and determines if they contain only
ASCII characters.
Input comes from files named on the command line, or from the
standard input if there are no filenames on the command line.
.PP
An ASCII character is any byte with a value of 0 through 127,
inclusive.
.SH OPTIONS
.TP
.BR -h ", " --help
Write out a short usage message.
.TP
.BR -q ", " --quiet
Do not write any output except error messages.
Indicate ASCII/not-ASCII status only via the exit code.
.SH "EXIT STATUS"
.B isascii
returns an exit code of 0 if all input files (or standard input) consisted
only of ASCII characters.
It returns a non-zero error code if there were errors or at least one of
the inputs was not pure ASCII.
.SH "SEE ALSO"
.BR isutf8 (1).