From 9a3009b8009f43f5d6d763c9e1e37ac9c5f8b358 Mon Sep 17 00:00:00 2001 From: "George V. Neville-Neil" Date: Tue, 19 May 2009 17:40:22 +0000 Subject: [PATCH] Add a new program, perror, which takes an errno as a command line argument and outputs the associated textual message in the same way that perror(3) would if called within a program. --- usr.bin/Makefile | 1 + usr.bin/perror/Makefile | 6 ++++ usr.bin/perror/perror.1 | 50 +++++++++++++++++++++++++++ usr.bin/perror/perror.c | 76 +++++++++++++++++++++++++++++++++++++++++ 4 files changed, 133 insertions(+) create mode 100644 usr.bin/perror/Makefile create mode 100644 usr.bin/perror/perror.1 create mode 100644 usr.bin/perror/perror.c diff --git a/usr.bin/Makefile b/usr.bin/Makefile index cdfaf1294313..f67bfc25e095 100644 --- a/usr.bin/Makefile +++ b/usr.bin/Makefile @@ -149,6 +149,7 @@ SUBDIR= alias \ passwd \ paste \ pathchk \ + perror \ pr \ printenv \ printf \ diff --git a/usr.bin/perror/Makefile b/usr.bin/perror/Makefile new file mode 100644 index 000000000000..39e5dfffab27 --- /dev/null +++ b/usr.bin/perror/Makefile @@ -0,0 +1,6 @@ +# $FreeBSD$ + +PROG= perror +SRCS= perror.c + +.include diff --git a/usr.bin/perror/perror.1 b/usr.bin/perror/perror.1 new file mode 100644 index 000000000000..7faf77f10d95 --- /dev/null +++ b/usr.bin/perror/perror.1 @@ -0,0 +1,50 @@ +.\" +.\" Copyright (c) 2009 Advanced Computing Technologies LLC +.\" Written by: George V. Neville-Neil +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd May 12, 2009 +.Dt PERROR 1 +.Os +.Sh NAME +.Nm perror +.Nd "print an error number as a string" +.Sh SYNOPSIS +.Nm +.Op Ar number +.Sh DESCRIPTION +The +.Nm +program takes a raw errno value and prints it as a string. +.Sh SEE ALSO +.Xr perror 3 +.Sh HISTORY +The +.Nm +program first appeared in +.Fx 8.0 . +.Sh AUTHORS +.An George V. Neville-Neil diff --git a/usr.bin/perror/perror.c b/usr.bin/perror/perror.c new file mode 100644 index 000000000000..749d3ea7d6c3 --- /dev/null +++ b/usr.bin/perror/perror.c @@ -0,0 +1,76 @@ +/*- + * Copyright (c) 2009 Advanced Computing Technologies LLC + * Written by: George V. Neville-Neil + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +#include +__FBSDID("$FreeBSD$"); + +#include +#include +#include +#include + +#define MAX_ERR 256 + +void usage() +{ + + printf("usage: perror number\n"); + printf("number must be between 1 and %d\n", ELAST); + exit(1); +} + +int main(int argc, char **argv) +{ + + char errstr[MAX_ERR]; + char *cp; + int errnum; + + if (argc != 2) + usage(); + + errnum = strtol(argv[1], &cp, 0); + + if (((errnum == 0) && (errno == EINVAL)) || (*cp != '\0')) { + printf("Argument %s not a number.\n", argv[1]); + usage(); + } + + if ((errnum <=0) || (errnum > ELAST)) { + printf("Number %d out of range.\n", errnum); + usage(); + } + + if (strerror_r(errnum, errstr, sizeof(errstr)) < 0) { + printf("Could not find error number %d.\n", errnum); + usage(); + } + + printf("Error %d is \"%s\"\n", errnum, errstr); + + exit(0); +}