Return to uname.1 CVS log

Up to [local] / src / usr.bin / uname

Document the OpenBSD-specific output format.
Feedback and OK millert, "more reasonable" deraadt@.

.\"	$OpenBSD: uname.1,v 1.19 2023/10/09 19:28:42 schwarze Exp $
.\"
.\" Copyright (c) 1990 The Regents of the University of California.
.\" 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.
.\" 3. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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.
.\"
.\"     from: @(#)du.1	6.13 (Berkeley) 6/20/91
.\"
.Dd $Mdocdate: October 9 2023 $
.Dt UNAME 1
.Os
.Sh NAME
.Nm uname
.Nd print operating system name
.Sh SYNOPSIS
.Nm uname
.Op Fl amnprsv
.Sh DESCRIPTION
The
.Nm uname
utility writes strings representing one or more system characteristics
to the standard output.
The formats and meanings of all these strings vary among operating systems.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl a
Behave as though all of the options
.Fl mnrsv
were specified.
.It Fl m
Print the name of the hardware type.
On
.Ox ,
this is the kernel architecture as returned by
.Xr machine 1 .
.It Fl n
Print the network name of this machine.
On
.Ox ,
the same name can be printed with
.Xr hostname 1 .
.It Fl p
Print the application architecture as returned by
.Xr arch 1
.Fl s .
.It Fl r
Print the operating system release.
On
.Ox ,
the format is
.Sm off
.Ar digit . digit Bq \- Ar flavor .
.Sm on
.Pp
The meaning of the
.Pf \- Ar flavor
suffix is as follows:
.Bl -tag -width "no suffix"
.It \-beta
A development version preceding the
.Ar digit . Ns Ar digit
release.
.It no suffix
A public release,
or a development version very closely preceding that release.
.It \-stable
A branch based on the
.Ar digit . Ns Ar digit
release that only contains patches to fix very important bugs.
.It \-current
A development version coming after the
.Ar digit . Ns Ar digit
release.
Some time before the subsequent release, the second
.Ar digit
is incremented and the
.Pf \- Ar flavor
switched to \-beta.
.El
.It Fl s
Print the operating system name.
On
.Ox ,
this is always
.Dq Ox .
.It Fl v
Print the operating system version.
On
.Ox ,
the format is
.Ar SYSTEMNAME Ns # Ns Ar buildnumber
with the
.Ar SYSTEMNAME
mentioned in
.Xr config 8 .
.El
.Pp
If no options are specified,
.Nm uname
prints the operating system name as if the
.Fl s
option had been specified.
.Pp
If
.Fl a
or more than one option is specified,
.Ox
prints the selected fields separated by single space characters
in the following order: operating system name, network name,
release, version, kernel architecture, application architecture.
.Sh EXIT STATUS
.Ex -std uname
.Sh SEE ALSO
.Xr hostname 1 ,
.Xr machine 1 ,
.Xr uname 3
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2008
specification.
.Pp
The flag
.Op Fl p
is an extension to that specification.
.Sh HISTORY
The
.Nm
command first appeared in PWB/UNIX 1.0
and was reimplemented for
.Bx 4.4 .