man7/uts_namespaces.7

   1 .\" Copyright (c) 2019 by Michael Kerrisk <mtk.manpages@gmail.com>
   2 .\"
   3 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   4 .\"
   5 .\"
   6 .TH uts_namespaces 7 (date) "Linux man-pages (unreleased)"
   7 .SH NAME
   8 uts_namespaces \- overview of Linux UTS namespaces
   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).
  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.
  24 .P
  25 When a process creates a new UTS namespace using
  26 .BR clone (2)
  27 or
  28 .BR unshare (2)
  29 with the
  30 .B CLONE_NEWUTS
  31 flag, the hostname and domain name of the new UTS namespace are copied
  32 from the corresponding values in the caller's UTS namespace.
  33 .P
  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),
  41 .BR getdomainname (2),
  42 .BR gethostname (2),
  43 .BR setns (2),
  44 .BR uname (2),
  45 .BR unshare (2),
  46 .BR namespaces (7)