]>
Commit | Line | Data |
---|---|---|
57829a0e MK |
1 | .\" Copyright (c) 2019 by Michael Kerrisk <mtk.manpages@gmail.com> |
2 | .\" | |
5fbde956 | 3 | .\" SPDX-License-Identifier: Linux-man-pages-copyleft |
57829a0e MK |
4 | .\" |
5 | .\" | |
4c1c5274 | 6 | .TH uts_namespaces 7 (date) "Linux man-pages (unreleased)" |
57829a0e | 7 | .SH NAME |
0549038d | 8 | uts_namespaces \- overview of Linux UTS namespaces |
57829a0e MK |
9 | .SH DESCRIPTION |
10 | UTS namespaces provide isolation of two system identifiers: | |
11 | the hostname and the NIS domain name. | |
12 | These identifiers are set using | |
13 | .BR sethostname (2) | |
14 | and | |
15 | .BR setdomainname (2), | |
16 | and can be retrieved using | |
17 | .BR uname (2), | |
18 | .BR gethostname (2), | |
19 | and | |
20 | .BR getdomainname (2). | |
4791ea7f MK |
21 | Changes made to these identifiers are visible to all other |
22 | processes in the same UTS namespace, | |
23 | but are not visible to processes in other UTS namespaces. | |
57829a0e | 24 | .PP |
57829a0e MK |
25 | When a process creates a new UTS namespace using |
26 | .BR clone (2) | |
27 | or | |
28 | .BR unshare (2) | |
29 | with the | |
1ae6b2c7 | 30 | .B CLONE_NEWUTS |
57829a0e MK |
31 | flag, the hostname and domain of the new UTS namespace are copied |
32 | from the corresponding values in the caller's UTS namespace. | |
33 | .PP | |
34 | Use of UTS namespaces requires a kernel that is configured with the | |
35 | .B CONFIG_UTS_NS | |
36 | option. | |
37 | .SH SEE ALSO | |
38 | .BR nsenter (1), | |
39 | .BR unshare (1), | |
40 | .BR clone (2), | |
252bba44 | 41 | .BR getdomainname (2), |
27f942ad | 42 | .BR gethostname (2), |
57829a0e | 43 | .BR setns (2), |
252bba44 | 44 | .BR uname (2), |
57829a0e MK |
45 | .BR unshare (2), |
46 | .BR namespaces (7) |