From e400e3578e5852ee9c366c8206053e870bbb5e72 Mon Sep 17 00:00:00 2001 From: Daniel Roskams Date: Sat, 1 Oct 2016 21:47:19 +0800 Subject: [PATCH] Document kernelinfo(1). --- utils/Makefile | 1 + utils/kernelinfo.1 | 36 ++++++++++++++++++++++++++++++++++++ utils/kernelinfo.c | 38 +++++++------------------------------- 3 files changed, 44 insertions(+), 31 deletions(-) create mode 100644 utils/kernelinfo.1 diff --git a/utils/Makefile b/utils/Makefile index b54909a7..dc091981 100644 --- a/utils/Makefile +++ b/utils/Makefile @@ -75,6 +75,7 @@ xinstall MANPAGES=\ chkblayout.1 \ +kernelinfo.1 \ readlink.1 \ all: $(BINARIES) diff --git a/utils/kernelinfo.1 b/utils/kernelinfo.1 new file mode 100644 index 00000000..ab28fb82 --- /dev/null +++ b/utils/kernelinfo.1 @@ -0,0 +1,36 @@ +.Dd October 01, 2016 +.Dt KERNELINFO 1 +.Os +.Sh NAME +.Nm kernelinfo +.Nd print kernel information +.Sh SYNOPSIS +.Nm +.Op Ar variable ... +.Sh DESCRIPTION +.Nm +prints the specified kernel information. +.Pp +Possible values for +.Ar variable +are: +.Bl -tag -width builddate +.It Sy name +The name of the current kernel. +.It Sy version +The version of the current kernel. +.It Sy tagline +The tagline (slogan) of the release. +.It Sy builddate +The date on which the current kernel was built. +.It Sy buildtime +The time at which the current kernel was built. +.It Sy firmware +The firmware of the system (e.g. "bios" or "uefi") +.El +.Sh EXIT STATUS +.Nm +will exit 0 on success and non-zero otherwise. +.Sh SEE ALSO +.Xr uname 1 , +.Xr kernelinfo 2 diff --git a/utils/kernelinfo.c b/utils/kernelinfo.c index 32d08c29..fd4af4d5 100644 --- a/utils/kernelinfo.c +++ b/utils/kernelinfo.c @@ -18,30 +18,16 @@ */ #include -#include -#include -#include + +#include #include #include - -static void help(FILE* fp, const char* argv0) -{ - fprintf(fp, "Usage: %s [OPTION]... REQUEST...\n", argv0); - fprintf(fp, "Prints a kernel information string.\n"); - fprintf(fp, "example: %s name\n", argv0); - fprintf(fp, "example: %s version\n", argv0); - fprintf(fp, "example: %s builddate\n", argv0); - fprintf(fp, "example: %s buildtime\n", argv0); -} - -static void version(FILE* fp, const char* argv0) -{ - fprintf(fp, "%s (Sortix) %s\n", argv0, VERSIONSTR); -} +#include +#include +#include int main(int argc, char* argv[]) { - const char* argv0 = argv[0]; for ( int i = 1; i < argc; i++ ) { const char* arg = argv[i]; @@ -56,21 +42,11 @@ int main(int argc, char* argv[]) while ( (c = *++arg) ) switch ( c ) { default: - fprintf(stderr, "%s: unknown option -- '%c'\n", argv0, c); - help(stderr, argv0); - exit(1); + errx(1, "unknown option -- '%c'\n", c); } } - else if ( !strcmp(arg, "--help") ) - help(stdout, argv0), exit(0); - else if ( !strcmp(arg, "--version") ) - version(stdout, argv0), exit(0); else - { - fprintf(stderr, "%s: unknown option: %s\n", argv0, arg); - help(stderr, argv0); - exit(1); - } + errx(1, "unknown option: %s\n", arg); } size_t bufsize = 32; char* buf = (char*) malloc(bufsize);