xref: /freebsd/usr.bin/uname/uname.1 (revision ab0dffafb704e258ce559a104fe0139df03d3f51)
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.\"
31*ab0dffafSAlexey Dokuchaev.Dd May 31, 2017
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
39876a7cf4SPeter Wemm.Op Fl aiKmnoprsUv
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.
56c4119c76SJuli Mallett.It Fl i
57c4119c76SJuli MallettWrite the kernel ident to standard output.
58876a7cf4SPeter Wemm.It Fl K
59876a7cf4SPeter WemmWrite the
60876a7cf4SPeter Wemm.Fx
61876a7cf4SPeter Wemmversion of the kernel.
629b50d902SRodney W. Grimes.It Fl m
639b50d902SRodney W. GrimesWrite the type of the current hardware platform to standard output.
64*ab0dffafSAlexey Dokuchaev.Po Xr make 1
65*ab0dffafSAlexey Dokuchaevuses it to set the
66*ab0dffafSAlexey Dokuchaev.Va MACHINE
67*ab0dffafSAlexey Dokuchaevvariable.
68*ab0dffafSAlexey Dokuchaev.Pc
699b50d902SRodney W. Grimes.It Fl n
709b50d902SRodney W. GrimesWrite the name of the system to standard output.
718293a8feSEd Maste.It Fl o
728293a8feSEd MasteThis is a synonym for the
738293a8feSEd Maste.Fl s
748293a8feSEd Masteoption, for compatibility with other systems.
757db98de9SSteve Price.It Fl p
761c6d3890SYoshihiro TakahashiWrite the type of the machine processor architecture to standard output.
77*ab0dffafSAlexey Dokuchaev.Po Xr make 1
78*ab0dffafSAlexey Dokuchaevuses it to set the
79*ab0dffafSAlexey Dokuchaev.Va MACHINE_ARCH
80*ab0dffafSAlexey Dokuchaevvariable.
81*ab0dffafSAlexey Dokuchaev.Pc
829b50d902SRodney W. Grimes.It Fl r
839b50d902SRodney W. GrimesWrite the current release level of the operating system
849b50d902SRodney W. Grimesto standard output.
859b50d902SRodney W. Grimes.It Fl s
869b50d902SRodney W. GrimesWrite the name of the operating system implementation to standard output.
87876a7cf4SPeter Wemm.It Fl U
88876a7cf4SPeter WemmWrite the
89876a7cf4SPeter Wemm.Fx
90876a7cf4SPeter Wemmversion of the user environment.
919b50d902SRodney W. Grimes.It Fl v
929b50d902SRodney W. GrimesWrite the version level of this release of the operating system
939b50d902SRodney W. Grimesto standard output.
949b50d902SRodney W. Grimes.El
959b50d902SRodney W. Grimes.Pp
969b50d902SRodney W. GrimesIf the
979b50d902SRodney W. Grimes.Fl a
989b50d902SRodney W. Grimesflag is specified, or multiple flags are specified, all
999b50d902SRodney W. Grimesoutput is written on a single line, separated by spaces.
100876a7cf4SPeter Wemm.Pp
101876a7cf4SPeter WemmThe
102876a7cf4SPeter Wemm.Fl K
103876a7cf4SPeter Wemmand
104876a7cf4SPeter Wemm.Fl U
105876a7cf4SPeter Wemmflags are intended to be used for fine grain differentiation of incremental
106876a7cf4SPeter Wemm.Fx
107876a7cf4SPeter Wemmdevelopment and user visible changes.
108bed4636eSJuli Mallett.Sh ENVIRONMENT
109bed4636eSJuli MallettAn environment variable composed of the string
110bed4636eSJuli Mallett.Ev UNAME_
111bed4636eSJuli Mallettfollowed by any flag to the
112bed4636eSJuli Mallett.Nm
113bed4636eSJuli Mallettutility (except for
114bed4636eSJuli Mallett.Fl a )
115bed4636eSJuli Mallettwill allow the corresponding data to be set to the contents
116bed4636eSJuli Mallettof the environment variable.
1176c7216dfSRuslan Ermilov.Sh EXIT STATUS
1186c7216dfSRuslan Ermilov.Ex -std
119*ab0dffafSAlexey Dokuchaev.Sh EXAMPLES
120*ab0dffafSAlexey DokuchaevThe hardware platform
121*ab0dffafSAlexey Dokuchaev.Pq Fl m
122*ab0dffafSAlexey Dokuchaevcan be different from the machine's processor architecture
123*ab0dffafSAlexey Dokuchaev.Pq Fl p ,
124*ab0dffafSAlexey Dokuchaeve.g., on 64-bit PowerPC,
125*ab0dffafSAlexey Dokuchaev.Fl m
126*ab0dffafSAlexey Dokuchaevwould return
127*ab0dffafSAlexey Dokuchaev.Va powerpc
128*ab0dffafSAlexey Dokuchaevand
129*ab0dffafSAlexey Dokuchaev.Fl p
130*ab0dffafSAlexey Dokuchaevwould return
131*ab0dffafSAlexey Dokuchaev.Va powerpc64 .
1329b50d902SRodney W. Grimes.Sh SEE ALSO
133876a7cf4SPeter Wemm.Xr feature_present 3 ,
134876a7cf4SPeter Wemm.Xr getosreldate 3 ,
1359b50d902SRodney W. Grimes.Xr sysctl 3 ,
136da1ff3cbSWolfram Schneider.Xr uname 3 ,
137da1ff3cbSWolfram Schneider.Xr sysctl 8
1389b50d902SRodney W. Grimes.Sh STANDARDS
1399b50d902SRodney W. GrimesThe
140c7c16bebSPhilippe Charnier.Nm
1419b50d902SRodney W. Grimescommand is expected to conform to the
1429b50d902SRodney W. Grimes.St -p1003.2
1439b50d902SRodney W. Grimesspecification.
1446c7216dfSRuslan Ermilov.Sh HISTORY
1456c7216dfSRuslan ErmilovThe
1466c7216dfSRuslan Ermilov.Nm
1476c7216dfSRuslan Ermilovcommand appeared in PWB UNIX.
148876a7cf4SPeter Wemm.Pp
149876a7cf4SPeter WemmThe
150876a7cf4SPeter Wemm.Fl K
151876a7cf4SPeter Wemmand
152876a7cf4SPeter Wemm.Fl U
153876a7cf4SPeter Wemmextension flags appeared in
154c9b53336SPeter Wemm.Fx 10.0 .
155