xref: /dragonfly/usr.bin/uname/uname.1 (revision 655933d6)
1.\" Copyright (c) 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. Neither the name of the University nor the names of its contributors
13.\"    may be used to endorse or promote products derived from this software
14.\"    without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\"	@(#)uname.1	8.3 (Berkeley) 4/8/94
29.\" $FreeBSD: src/usr.bin/uname/uname.1,v 1.8.2.4 2002/10/17 07:47:29 jmallett Exp $
30.\" $DragonFly: src/usr.bin/uname/uname.1,v 1.5 2007/07/30 22:11:33 swildner Exp $
31.\"
32.Dd July 8, 2021
33.Dt UNAME 1
34.Os
35.Sh NAME
36.Nm uname
37.Nd display information about the system
38.Sh SYNOPSIS
39.Nm
40.Op Fl aiKmnprsUvP
41.Sh DESCRIPTION
42The
43.Nm
44command writes the name of the operating system implementation to
45standard output.
46When options are specified, strings representing one or more system
47characteristics are written to standard output.
48.Pp
49The options are as follows:
50.Bl -tag -width indent
51.It Fl a
52Behave as though the options
53.Fl m , n , r , s ,
54and
55.Fl v
56were specified.
57.It Fl i
58Write the kernel ident to standard output.
59.It Fl K
60Write the
61.Dx
62version of the kernel.
63.It Fl m
64Write the type of the current hardware platform to standard output.
65.It Fl n
66Write the name of the system to standard output.
67.It Fl p
68Write the type of the machine processor architecture to standard output.
69.It Fl r
70Write the current release level of the operating system
71to standard output.
72.It Fl s
73Write the name of the operating system implementation to standard output.
74.It Fl U
75Write the
76.Dx
77version of the user environment.
78.It Fl v
79Write the version level of this release of the operating system
80to standard output.
81.It Fl P
82Generates a default ABI: configuration string for dports / pkgng to
83the standard output, including odd-to-even version-munging.
84.It Fl PP
85Generates a default ABI: configuration string for dports / pkgng to
86the standard output, without version-munging.
87.El
88.Pp
89If the
90.Fl a
91flag is specified, or multiple flags are specified, all
92output is written on a single line, separated by spaces.
93.Pp
94The
95.Fl K
96and
97.Fl U
98flags are intended to be used for fine grain differentiation of incremental
99.Dx
100development and user visible changes.
101.Sh ENVIRONMENT
102An environment variable composed of the string
103.Ev UNAME_
104followed by any flag to the
105.Nm
106utility (except for
107.Fl a )
108will allow the corresponding data to be set to the contents
109of the environment variable.
110.Pp
111A varsym composed of the string
112.Ev UNAME_
113followed by any flag to the
114.Nm
115utility (except for
116.Fl a )
117will allow the corresponding data to be set from the contents
118of the varsym.
119Environment variables override varsyms in this case.
120.Sh EXIT STATUS
121.Ex -std
122.Sh SEE ALSO
123.Xr varsym 1 ,
124.Xr sysctl 3 ,
125.Xr uname 3 ,
126.Xr sysctl 8
127.Sh STANDARDS
128The
129.Nm
130command is expected to conform to the
131.St -p1003.2
132specification.
133.Sh HISTORY
134The
135.Nm
136command appeared in PWB
137.Ux .
138