[ViewVC] Diff of: cvs/Linux-Clone/README

Comparing Linux-Clone/README (file contents):
Revision 1.3 by root, Thu Nov 2 07:31:16 2017 UTC vs.
Revision 1.4 by root, Tue Sep 6 10:57:02 2022 UTC

 SYNOPSIS
      use Linux::Clone;
 DESCRIPTION
-    This module exposes the linux clone(2), unshare(2) and related syscalls
+    This module exposes the linux clone(2), unshare(2) and some related
-    to Perl.
+    syscalls to Perl.
     $retval = unshare $flags
         The following CLONE_ flag values (without CLONE_ prefix) are
         supported for unshare, if found, in this release. See the
         documentation for unshare(2) for more info on what they do:
            Linux::Clone::NEWPID
            Linux::Clone::NEWUTS
            Linux::Clone::NEWIPC
            Linux::Clone::NEWNET
            Linux::Clone::NEWCGROUP
+           Linux::Clone::NEWTIME
         Example: unshare the network namespace and prove that by calling
-        ifconfig, showing only an unconfigured lo interface.
+        ifconfig, showing only the unconfigured lo interface.
            Linux::Clone::unshare Linux::Clone::NEWNET
               and "unshare: $!";
+           Linux::Clone::configure_loopback;
-           system "ifconfig -a";
+           system "ifconfig";
         Example: unshare the network namespace, initialise the loopback
         interface, create a veth interface pair, put one interface into the
         parent processes namespace (use ifconfig -a from another shell),
         configure the other interface with 192.168.99.2 -> 192.168.99.1 and
            # unshare our network namespace
            Linux::Clone::unshare Linux::Clone::NEWNET
              and "unshare: $!";
+           Linux::Clone::configure_loopback;
            my $ppid = getppid;
            system "
-              # configure loopback interface
-              ip link set lo up
-              ip route add 127.0.0.0/8 dev lo
               # create veth pair
               ip link add name veth_master type veth peer name veth_slave
               # move veth_master to our parent process' namespace
               ip link set veth_master netns $ppid
            use Linux::Clone;
            Linux::Clone::unshare Linux::Clone::NEWNS
               and die "unshare: $!";
-           # now bind-mount /lib over /etc and ls -l /etc - scary
+           # now bind-mount /lib over /etc and ls -l /etc - looks scary
            system "mount -n --bind /lib /etc";
            system "ls -l /etc";
     $retval = Linux::Clone::clone $coderef, $stacksize, $flags[, $ptid,
     $tls, $ctid]
            Linux::Clone::VFORK
            Linux::Clone::SETTLS         (not yet implemented)
            Linux::Clone::PARENT_SETTID  (not yet implemented)
            Linux::Clone::CHILD_SETTID   (not yet implemented)
            Linux::Clone::CHILD_CLEARTID (not yet implemented)
+           Linux::Clone::PIDFD          (not yet implemented)
            Linux::Clone::DETACHED
            Linux::Clone::UNTRACED
            Linux::Clone::IO
+           Linux::Clone::CSIGNAL exit signal mask
         Note that for practical reasons you basically must not use
         "Linux::Clone::VM" or "Linux::Clone::VFORK", as perl is unlikely to
         cope with that.
     Linux::Clone::setns $fh_or_fd[, $nstype]
         Calls setns(2) on the file descriptor (or file handle) $fh_or_fd. If
         $nstype is missing, then 0 is used.
         The argument $nstype can be 0, "Linux::Clone::NEWIPC",
-        "Linux::Clone::NEWNET", "Linux::Clone::NEUTS",
+        "Linux::Clone::NEWNET", "Linux::Clone::NEWUTS",
         "Linux::Clone::NEWCGROUP", "Linux::Clone::NEWNS",
         "Linux::Clone::NEWPID" or "Linux::Clone::NEWUSER".
     Linux::Clone::pivot_root $new_root, $old_root
         Calls pivot_root(2) - refer to its manpage for details.
         The following $type constants are available if the kcmp syscall
         number was available during compilation:
         "Linux::Clone::KCMP_FILE", "Linux::Clone::KCMP_VM",
         "Linux::Clone::KCMP_FILES", "Linux::Clone::KCMP_FS",
-        "Linux::Clone::KCMP_SIGHAND", "Linux::Clone::KCMP_IO" and
+        "Linux::Clone::KCMP_SIGHAND", "Linux::Clone::KCMP_IO",
-        "Linux::Clone::KCMP_SYSVSEM".
+        "Linux::Clone::KCMP_SYSVSEM" and "Linux::Clone::KCMP_EPOLL_TFD".
+    Linux::Clone::configure_loopback
+        Configures a working loopback interface (basically, does the
+        equivalent of "ifconfig lo up" which automatically adds ipv4/ipv6
+        addresses and routes), which can be useful to get a network
+        namespace going.
+        Dies on error and returns nothing.
+    "ioctl" symbols
+        The following ioctl symbols are also provided by this module (see
+        ioctl_ns(8)).
+           Linux::Clone::NS_GET_USERNS
+           Linux::Clone::NS_GET_PARENT
+           Linux::Clone::NS_GET_NSTYPE
+           Linux::Clone::NS_OWNER_UID
+SEE ALSO
+    IO::AIO has some related functions, such as "pidfd_send_signal", and
+    some unrelated functions that might be useful.
+    namspaces(7), cgroup_namespaces(7), pid_namespaces(7),
+    user_namespaces(7), time_namespaces(7), ip-netns(8), switch_root(8),
+    ioctl_ns(2), lsns(8)Q
 AUTHOR
      Marc Lehmann <schmorp@schmorp.de>
      http://home.schmorp.de/

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing Linux-Clone/README (file contents): Revision 1.3 by root, Thu Nov 2 07:31:16 2017 UTC vs. Revision 1.4 by root, Tue Sep 6 10:57:02 2022 UTC

Diff Legend

Comparing Linux-Clone/README (file contents):
Revision 1.3 by root, Thu Nov 2 07:31:16 2017 UTC vs.
Revision 1.4 by root, Tue Sep 6 10:57:02 2022 UTC