svn commit: r192398 - in head/usr.bin: . perror

Tue May 19 17:40:23 UTC 2009

Author: gnn
Date: Tue May 19 17:40:22 2009
New Revision: 192398
URL: http://svn.freebsd.org/changeset/base/192398

Log:
  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.

Added:
  head/usr.bin/perror/
  head/usr.bin/perror/Makefile   (contents, props changed)
  head/usr.bin/perror/perror.1   (contents, props changed)
  head/usr.bin/perror/perror.c   (contents, props changed)
Modified:
  head/usr.bin/Makefile

Modified: head/usr.bin/Makefile
==============================================================================

--- head/usr.bin/Makefile	Tue May 19 17:35:15 2009	(r192397)
+++ head/usr.bin/Makefile	Tue May 19 17:40:22 2009	(r192398)
@@ -149,6 +149,7 @@ SUBDIR=	alias \
 	passwd \
 	paste \
 	pathchk \
+	perror \
 	pr \
 	printenv \
 	printf \

Added: head/usr.bin/perror/Makefile
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ head/usr.bin/perror/Makefile	Tue May 19 17:40:22 2009	(r192398)
@@ -0,0 +1,6 @@
+# $FreeBSD$
+
+PROG=	perror
+SRCS=	perror.c 
+
+.include <bsd.prog.mk>

Added: head/usr.bin/perror/perror.1
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ head/usr.bin/perror/perror.1	Tue May 19 17:40:22 2009	(r192398)
@@ -0,0 +1,50 @@
+.\" 
+.\" Copyright (c) 2009 Advanced Computing Technologies LLC
+.\" Written by: George V. Neville-Neil <gnn at FreeBSD.org>
+.\" 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

Added: head/usr.bin/perror/perror.c
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ head/usr.bin/perror/perror.c	Tue May 19 17:40:22 2009	(r192398)
@@ -0,0 +1,76 @@
+/*-
+ * Copyright (c) 2009 Advanced Computing Technologies LLC
+ * Written by: George V. Neville-Neil <gnn at FreeBSD.org>
+ * 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 <sys/cdefs.h>
+__FBSDID("$FreeBSD$");
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <sys/errno.h>
+
+#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);
+}
