xref: /freebsd/usr.bin/uname/uname.1 (revision 473cb30cd1f15f5dfe3a19f965da0e1e2df12025)
19b50d902SRodney W. Grimes.\" Copyright (c) 1993
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
69b50d902SRodney W. Grimes.\" are met:
79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
89b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
109b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
119b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
12fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
139b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
149b50d902SRodney W. Grimes.\"    without specific prior written permission.
159b50d902SRodney W. Grimes.\"
169b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
179b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
189b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
199b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
209b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
219b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
229b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
239b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
249b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
259b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
269b50d902SRodney W. Grimes.\" SUCH DAMAGE.
279b50d902SRodney W. Grimes.\"
289b50d902SRodney W. Grimes.\"	@(#)uname.1	8.3 (Berkeley) 4/8/94
29c3aac50fSPeter Wemm.\" $FreeBSD$
309b50d902SRodney W. Grimes.\"
31fb9a9855SEd Maste.Dd June 27, 2019
329b50d902SRodney W. Grimes.Dt UNAME 1
339b50d902SRodney W. Grimes.Os
349b50d902SRodney W. Grimes.Sh NAME
359b50d902SRodney W. Grimes.Nm uname
369b50d902SRodney W. Grimes.Nd display information about the system
379b50d902SRodney W. Grimes.Sh SYNOPSIS
38c7c16bebSPhilippe Charnier.Nm
39fb9a9855SEd Maste.Op Fl abiKmnoprsUv
409b50d902SRodney W. Grimes.Sh DESCRIPTION
419b50d902SRodney W. GrimesThe
42c7c16bebSPhilippe Charnier.Nm
439b50d902SRodney W. Grimescommand writes the name of the operating system implementation to
449b50d902SRodney W. Grimesstandard output.
459b50d902SRodney W. GrimesWhen options are specified, strings representing one or more system
469b50d902SRodney W. Grimescharacteristics are written to standard output.
479b50d902SRodney W. Grimes.Pp
489b50d902SRodney W. GrimesThe options are as follows:
4962eaa6eeSRuslan Ermilov.Bl -tag -width indent
509b50d902SRodney W. Grimes.It Fl a
519b50d902SRodney W. GrimesBehave as though the options
5262eaa6eeSRuslan Ermilov.Fl m , n , r , s ,
539b50d902SRodney W. Grimesand
549b50d902SRodney W. Grimes.Fl v
559b50d902SRodney W. Grimeswere specified.
56fb9a9855SEd Maste.It Fl b
57fb9a9855SEd MasteWrite the kernel's linker-generated build-id to standard output.
58c4119c76SJuli Mallett.It Fl i
59c4119c76SJuli MallettWrite the kernel ident to standard output.
60876a7cf4SPeter Wemm.It Fl K
61876a7cf4SPeter WemmWrite the
62876a7cf4SPeter Wemm.Fx
63876a7cf4SPeter Wemmversion of the kernel.
649b50d902SRodney W. Grimes.It Fl m
659b50d902SRodney W. GrimesWrite the type of the current hardware platform to standard output.
66ab0dffafSAlexey Dokuchaev.Po Xr make 1
67ab0dffafSAlexey Dokuchaevuses it to set the
68ab0dffafSAlexey Dokuchaev.Va MACHINE
69ab0dffafSAlexey Dokuchaevvariable.
70ab0dffafSAlexey Dokuchaev.Pc
719b50d902SRodney W. Grimes.It Fl n
729b50d902SRodney W. GrimesWrite the name of the system to standard output.
738293a8feSEd Maste.It Fl o
748293a8feSEd MasteThis is a synonym for the
758293a8feSEd Maste.Fl s
768293a8feSEd Masteoption, for compatibility with other systems.
777db98de9SSteve Price.It Fl p
781c6d3890SYoshihiro TakahashiWrite the type of the machine processor architecture to standard output.
79ab0dffafSAlexey Dokuchaev.Po Xr make 1
80ab0dffafSAlexey Dokuchaevuses it to set the
81ab0dffafSAlexey Dokuchaev.Va MACHINE_ARCH
82ab0dffafSAlexey Dokuchaevvariable.
83ab0dffafSAlexey Dokuchaev.Pc
849b50d902SRodney W. Grimes.It Fl r
859b50d902SRodney W. GrimesWrite the current release level of the operating system
869b50d902SRodney W. Grimesto standard output.
879b50d902SRodney W. Grimes.It Fl s
889b50d902SRodney W. GrimesWrite the name of the operating system implementation to standard output.
89876a7cf4SPeter Wemm.It Fl U
90876a7cf4SPeter WemmWrite the
91876a7cf4SPeter Wemm.Fx
92876a7cf4SPeter Wemmversion of the user environment.
939b50d902SRodney W. Grimes.It Fl v
949b50d902SRodney W. GrimesWrite the version level of this release of the operating system
959b50d902SRodney W. Grimesto standard output.
969b50d902SRodney W. Grimes.El
979b50d902SRodney W. Grimes.Pp
989b50d902SRodney W. GrimesIf the
999b50d902SRodney W. Grimes.Fl a
1009b50d902SRodney W. Grimesflag is specified, or multiple flags are specified, all
1019b50d902SRodney W. Grimesoutput is written on a single line, separated by spaces.
102876a7cf4SPeter Wemm.Pp
103876a7cf4SPeter WemmThe
104876a7cf4SPeter Wemm.Fl K
105876a7cf4SPeter Wemmand
106876a7cf4SPeter Wemm.Fl U
107876a7cf4SPeter Wemmflags are intended to be used for fine grain differentiation of incremental
108876a7cf4SPeter Wemm.Fx
109876a7cf4SPeter Wemmdevelopment and user visible changes.
110bed4636eSJuli Mallett.Sh ENVIRONMENT
111bed4636eSJuli MallettAn environment variable composed of the string
112bed4636eSJuli Mallett.Ev UNAME_
113bed4636eSJuli Mallettfollowed by any flag to the
114bed4636eSJuli Mallett.Nm
115bed4636eSJuli Mallettutility (except for
116bed4636eSJuli Mallett.Fl a )
117bed4636eSJuli Mallettwill allow the corresponding data to be set to the contents
118bed4636eSJuli Mallettof the environment variable.
1196c7216dfSRuslan Ermilov.Sh EXIT STATUS
1206c7216dfSRuslan Ermilov.Ex -std
121ab0dffafSAlexey Dokuchaev.Sh EXAMPLES
122ab0dffafSAlexey DokuchaevThe hardware platform
123ab0dffafSAlexey Dokuchaev.Pq Fl m
124ab0dffafSAlexey Dokuchaevcan be different from the machine's processor architecture
125ab0dffafSAlexey Dokuchaev.Pq Fl p ,
126ab0dffafSAlexey Dokuchaeve.g., on 64-bit PowerPC,
127ab0dffafSAlexey Dokuchaev.Fl m
128ab0dffafSAlexey Dokuchaevwould return
129ab0dffafSAlexey Dokuchaev.Va powerpc
130ab0dffafSAlexey Dokuchaevand
131ab0dffafSAlexey Dokuchaev.Fl p
132ab0dffafSAlexey Dokuchaevwould return
133ab0dffafSAlexey Dokuchaev.Va powerpc64 .
1349b50d902SRodney W. Grimes.Sh SEE ALSO
135876a7cf4SPeter Wemm.Xr feature_present 3 ,
136876a7cf4SPeter Wemm.Xr getosreldate 3 ,
1379b50d902SRodney W. Grimes.Xr sysctl 3 ,
138da1ff3cbSWolfram Schneider.Xr uname 3 ,
139da1ff3cbSWolfram Schneider.Xr sysctl 8
1409b50d902SRodney W. Grimes.Sh STANDARDS
1419b50d902SRodney W. GrimesThe
142c7c16bebSPhilippe Charnier.Nm
1439b50d902SRodney W. Grimescommand is expected to conform to the
1449b50d902SRodney W. Grimes.St -p1003.2
1459b50d902SRodney W. Grimesspecification.
1466c7216dfSRuslan Ermilov.Sh HISTORY
1476c7216dfSRuslan ErmilovThe
1486c7216dfSRuslan Ermilov.Nm
149*473cb30cSWarner Loshcommand appeared in PWB UNIX 1.0, however
150*473cb30cSWarner Losh.Bx 4.4
151*473cb30cSWarner Loshwas the first Berkeley release with the
152*473cb30cSWarner Losh.Nm
153*473cb30cSWarner Loshcommand.
154876a7cf4SPeter Wemm.Pp
155876a7cf4SPeter WemmThe
156876a7cf4SPeter Wemm.Fl K
157876a7cf4SPeter Wemmand
158876a7cf4SPeter Wemm.Fl U
159876a7cf4SPeter Wemmextension flags appeared in
160c9b53336SPeter Wemm.Fx 10.0 .
161fb9a9855SEd MasteThe
162fb9a9855SEd Maste.Fl b
163fb9a9855SEd Masteextension flag appeared in
164fb9a9855SEd Maste.Fx 13.0 .
165