man7/uts_namespaces.7

   1 .\" Copyright (c) 2019 by Michael Kerrisk <mtk.manpages@gmail.com>
   2 .\"
   3 .\" %%%LICENSE_START(VERBATIM)
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.  The author(s) may not
  17 .\" have taken the same level of care in the production of this manual,
  18 .\" which is licensed free of charge, as they might when working
  19 .\" professionally.
  20 .\"
  21 .\" Formatted or processed versions of this manual, if unaccompanied by
  22 .\" the source, must acknowledge the copyright and authors of this work.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\"
  26 .TH UTS_NAMESPACES 7 2019-11-19 "Linux" "Linux Programmer's Manual"
  27 .SH NAME
  28 uts_namespaces \- overview of Linux UTS namespaces
  29 .SH DESCRIPTION
  30 UTS namespaces provide isolation of two system identifiers:
  31 the hostname and the NIS domain name.
  32 These identifiers are set using
  33 .BR sethostname (2)
  34 and
  35 .BR setdomainname (2),
  36 and can be retrieved using
  37 .BR uname (2),
  38 .BR gethostname (2),
  39 and
  40 .BR getdomainname (2).
  41 Changes made to these identifiers are visible to all other
  42 processes in the same UTS namespace,
  43 but are not visible to processes in other UTS namespaces.
  44 .PP
  45 .PP
  46 When a process creates a new UTS namespace using
  47 .BR clone (2)
  48 or
  49 .BR unshare (2)
  50 with the
  51 .BR CLONE_NEWUTS
  52 flag, the hostname and domain of the new UTS namespace are copied
  53 from the corresponding values in the caller's UTS namespace.
  54 .PP
  55 Use of UTS namespaces requires a kernel that is configured with the
  56 .B CONFIG_UTS_NS
  57 option.
  58 .SH SEE ALSO
  59 .BR nsenter (1),
  60 .BR unshare (1),
  61 .BR clone (2),
  62 .BR getdomainname (2),
  63 .BR gethostname (2),
  64 .BR setns (2),
  65 .BR uname (2),
  66 .BR unshare (2),
  67 .BR namespaces (7)