d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
f4cf3aa68b
freebsd-skq/usr.bin/uname/uname.1

171 lines
4.3 KiB
Groff
Raw Normal View History

BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.\" Copyright (c) 1993
.\" 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.
Renumber copyright clause 4 Renumber cluase 4 to 3, per what everybody else did when BSD granted them permission to remove clause 3. My insistance on keeping the same numbering for legal reasons is too pedantic, so give up on that point. Submitted by: Jan Schaumann <jschauma@stevens.edu> Pull Request: https://github.com/freebsd/freebsd/pull/96
2017-02-28 23:42:47 +00:00
.\" 3. Neither the name of the University nor the names of its contributors
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.\" 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.
.\"
.\" @(#)uname.1 8.3 (Berkeley) 4/8/94
$Id$ -> $FreeBSD$
1999-08-28 01:08:13 +00:00
.\" $FreeBSD$
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.\"
uname(1): Fix a typo in the man page date MFC after: 3 days
2020-12-19 12:55:27 +00:00
.Dd November 13, 2020
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Dt UNAME 1
.Os
.Sh NAME
.Nm uname
.Nd display information about the system
.Sh SYNOPSIS
Nm uname -> Nm.
1997-08-20 11:03:54 +00:00
.Nm
Expose the kernel's build-ID through `uname -b` After r348611 the kernel's build-ID is available via sysctl. Add a -b flag to uname to report it. Submitted by: Ali Mashtizadeh <ali_mashtizadeh.com> Reviewed by: markj, imp Relnotes: Yes Event: Waterloo Hackathon 2019 Differential Revision: https://reviews.freebsd.org/D20511
2019-06-27 20:34:50 +00:00
.Op Fl abiKmnoprsUv
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Sh DESCRIPTION
The
Nm uname -> Nm.
1997-08-20 11:03:54 +00:00
.Nm
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
command writes the name of the operating system implementation to
standard output.
When options are specified, strings representing one or more system
characteristics are written to standard output.
.Pp
The options are as follows:
mdoc(7) police: bump document date for the -p change, tidy up the markup.
2002-01-17 10:38:32 +00:00
.Bl -tag -width indent
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl a
Behave as though the options
mdoc(7) police: bump document date for the -p change, tidy up the markup.
2002-01-17 10:38:32 +00:00
.Fl m , n , r , s ,
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
and
.Fl v
were specified.
Expose the kernel's build-ID through `uname -b` After r348611 the kernel's build-ID is available via sysctl. Add a -b flag to uname to report it. Submitted by: Ali Mashtizadeh <ali_mashtizadeh.com> Reviewed by: markj, imp Relnotes: Yes Event: Waterloo Hackathon 2019 Differential Revision: https://reviews.freebsd.org/D20511
2019-06-27 20:34:50 +00:00
.It Fl b
Write the kernel's linker-generated build-id to standard output.
Make kernel identification (`ident' in the config(8) driver) available to userland, and the kernel. In the kernel by way of the 'ident[]' variable akin to all the other stuff generated by newvers.sh. In userland it is available to sysctl consumers via KERN_IDENT or 'kern.ident'. It is exported by uname(1) by the -i flag. Reviewed by: hackers@
2003-06-09 09:38:20 +00:00
.It Fl i
Write the kernel ident to standard output.
Add -K (__FreeBSD_version of kernel) and -U (__FreeBSD_version of userland). Things like Makefile.inc1 resort to parsing /usr/include/osreldate.h with awk because this isn't easily available by other means. The separation of user and kernel versions is important for jail/chroot environments.
2013-10-15 20:57:40 +00:00
.It Fl K
Write the
.Fx
version of the kernel.
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl m
Write the type of the current hardware platform to standard output.
- Add a simple example to uname(1) manual page to show how the hardware platform (returned by -m) can be different from the machine's processor architecture (-p) - Document that make(1) sets universal MACHINE and MACHINE_ARCH variables based on these values Reviewed by: imp, manpages (bjk) Approved by: bjk, imp (implied) Differential Revision: https://reviews.freebsd.org/D10489
2017-05-31 03:44:31 +00:00
.Po Xr make 1
uses it to set the
.Va MACHINE
variable.
.Pc
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl n
Write the name of the system to standard output.
Allow -o as a synonym for -s, for compatibility with other systems. Using -s is preferred, but some existing scripts and makefiles expect to get the system name from uname -o. Reviewed by: imp
2010-01-26 20:02:53 +00:00
.It Fl o
This is a synonym for the
.Fl s
option, for compatibility with other systems.
Add a -p option which is the same as the -m option but provided for SVR4 compatibility. PR: 5826
1998-02-24 16:57:49 +00:00
.It Fl p
'uname -p' prints the value of hw.machine_arch instead of hw.machine. Reviewed by: imp No response from: -arch MFC after: 3 weeks
2002-01-14 12:49:46 +00:00
Write the type of the machine processor architecture to standard output.
- Add a simple example to uname(1) manual page to show how the hardware platform (returned by -m) can be different from the machine's processor architecture (-p) - Document that make(1) sets universal MACHINE and MACHINE_ARCH variables based on these values Reviewed by: imp, manpages (bjk) Approved by: bjk, imp (implied) Differential Revision: https://reviews.freebsd.org/D10489
2017-05-31 03:44:31 +00:00
.Po Xr make 1
uses it to set the
.Va MACHINE_ARCH
variable.
.Pc
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl r
Write the current release level of the operating system
to standard output.
.It Fl s
Write the name of the operating system implementation to standard output.
Add -K (__FreeBSD_version of kernel) and -U (__FreeBSD_version of userland). Things like Makefile.inc1 resort to parsing /usr/include/osreldate.h with awk because this isn't easily available by other means. The separation of user and kernel versions is important for jail/chroot environments.
2013-10-15 20:57:40 +00:00
.It Fl U
Write the
.Fx
version of the user environment.
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl v
Write the version level of this release of the operating system
to standard output.
.El
.Pp
If the
.Fl a
flag is specified, or multiple flags are specified, all
output is written on a single line, separated by spaces.
Add -K (__FreeBSD_version of kernel) and -U (__FreeBSD_version of userland). Things like Makefile.inc1 resort to parsing /usr/include/osreldate.h with awk because this isn't easily available by other means. The separation of user and kernel versions is important for jail/chroot environments.
2013-10-15 20:57:40 +00:00
.Pp
The
.Fl K
and
.Fl U
flags are intended to be used for fine grain differentiation of incremental
.Fx
development and user visible changes.
Document the order in which the kernel and the user environment versions are printed when both -K and -U options are passed on the command line. Approved by: 0mp Differential Revision: https://reviews.freebsd.org/D25970
2020-08-10 09:03:29 +00:00
Note that when both of these two options are specified, regardless of their
order, the kernel version would be printed first, followed by the user
environment version.
Mostly rewrite the flag handling of uname(1) to be overridable, such as: freefall% uname -s FreeBSD freefall% env UNAME_s=Linnex ./uname -s Linnex MFC after: 1 month
2002-09-18 04:33:10 +00:00
.Sh ENVIRONMENT
An environment variable composed of the string
.Ev UNAME_
followed by any flag to the
.Nm
utility (except for
.Fl a )
will allow the corresponding data to be set to the contents
of the environment variable.
Explicitly note in the EXAMPLES section that uname(3) contains more details MFC after: 1 week
2020-11-13 14:48:37 +00:00
See
.Xr uname 3
for more information.
Sort sections.
2005-01-18 13:43:56 +00:00
.Sh EXIT STATUS
.Ex -std
- Add a simple example to uname(1) manual page to show how the hardware platform (returned by -m) can be different from the machine's processor architecture (-p) - Document that make(1) sets universal MACHINE and MACHINE_ARCH variables based on these values Reviewed by: imp, manpages (bjk) Approved by: bjk, imp (implied) Differential Revision: https://reviews.freebsd.org/D10489
2017-05-31 03:44:31 +00:00
.Sh EXAMPLES
The hardware platform
.Pq Fl m
can be different from the machine's processor architecture
.Pq Fl p ,
e.g., on 64-bit PowerPC,
.Fl m
would return
.Va powerpc
and
.Fl p
would return
.Va powerpc64 .
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Sh SEE ALSO
Add -K (__FreeBSD_version of kernel) and -U (__FreeBSD_version of userland). Things like Makefile.inc1 resort to parsing /usr/include/osreldate.h with awk because this isn't easily available by other means. The separation of user and kernel versions is important for jail/chroot environments.
2013-10-15 20:57:40 +00:00
.Xr feature_present 3 ,
.Xr getosreldate 3 ,
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Xr sysctl 3 ,
Sort cross references.
1997-01-15 23:25:55 +00:00
.Xr uname 3 ,
.Xr sysctl 8
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Sh STANDARDS
The
Nm uname -> Nm.
1997-08-20 11:03:54 +00:00
.Nm
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
command is expected to conform to the
.St -p1003.2
specification.
Sort sections.
2005-01-18 13:43:56 +00:00
.Sh HISTORY
The
.Nm
Refine the history of uname. It appeared in 4.4BSD. It was not in v7 unix. It was one of the additions in PWB, and appeared in System III and later commercial versions of Unix. The different args to uname weren't aded until System III. Add a quick note to note the late entry into the BSD fork of Unix since PWB otherwise implies a pre-fork date.
2020-05-12 22:44:51 +00:00
command appeared in PWB UNIX 1.0, however
.Bx 4.4
was the first Berkeley release with the
.Nm
command.
Add -K (__FreeBSD_version of kernel) and -U (__FreeBSD_version of userland). Things like Makefile.inc1 resort to parsing /usr/include/osreldate.h with awk because this isn't easily available by other means. The separation of user and kernel versions is important for jail/chroot environments.
2013-10-15 20:57:40 +00:00
.Pp
The
.Fl K
and
.Fl U
extension flags appeared in
Change introduction history.
2013-11-20 17:48:38 +00:00
.Fx 10.0 .
Expose the kernel's build-ID through `uname -b` After r348611 the kernel's build-ID is available via sysctl. Add a -b flag to uname to report it. Submitted by: Ali Mashtizadeh <ali_mashtizadeh.com> Reviewed by: markj, imp Relnotes: Yes Event: Waterloo Hackathon 2019 Differential Revision: https://reviews.freebsd.org/D20511
2019-06-27 20:34:50 +00:00
The
.Fl b
extension flag appeared in
.Fx 13.0 .
Reference in New Issue Copy Permalink