--- uml-utilities-20070815.orig/debian/README.Debian +++ uml-utilities-20070815/debian/README.Debian @@ -0,0 +1,54 @@ +The easiest way to use virtual networking is to use the "daemon" +transport with the uml_switch instance which is configured and running +by default. + +1. Add an entry to /etc/network/interfaces to configure a persistent +tap interface on the host: + +auto tap0 +iface tap0 inet static + address 192.168.1.1 + netmask 255.255.255.0 + tunctl_user uml-net + +2. Configure uml_switch to connect to this interface by editing +/etc/default/uml-utilities: + +UML_SWITCH_OPTIONS="-tap tap0" + +3. Activate the tap interface: + +# ifup tap0 + +4. Restart the daemon + +# /etc/init.d/uml-utilities restart + +5. Use the "daemon" transport with UML: + +$ linux eth0=daemon + +You should then be able to pass traffic between UML and the host over +the tap interface. You may also set up forwarding, masquerading, +etc. in order to communicate beyond the host. It is convenient to run +dhcpd on the host, configured to listen on the tap0 interface and +provide configuration information for UMLs as needed. + +As an alternative to the above procedure, to enable virtual networking +using TUN/TAP directly from UML (the "tuntap" transport), add trusted +users to the uml-net group, e.g.: + +adduser bill uml-net + +If you wish to use a different group or different permissions, use a +statoverride for /usr/lib/uml/uml_net. Note that members of the +uml-net group will have privileges to do potentially harmful things to +the system, such as reconfiguring network interfaces. + +Note also that the uml_net helper is installed in a different place in this +package than by the upstream distribution (/usr/lib/uml/uml_net rather than +PREFIX/bin/uml_net). This is done in order to comply with FHS. because +uml_net is not meant to be executed by users, it does not belong in the system +PATH. + + -- Matt Zimmerman , Sun Sep 28 23:08:26 2003 --- uml-utilities-20070815.orig/debian/changelog +++ uml-utilities-20070815/debian/changelog @@ -0,0 +1,462 @@ +uml-utilities (20070815-1.4) unstable; urgency=low + + * Non-maintainer upload. + * Stop shipping /var/run/uml-utilities, thanks to Thomas Goirand. The + initscript already created this if it was missing. (Closes: #689905) + * Set Architecture: linux-any. (Closes: #745188, #637724) + + -- Andreas Beckmann Tue, 04 Nov 2014 14:05:53 +0100 + +uml-utilities (20070815-1.3) unstable; urgency=low + + * Non-maintainer upload. + * Don't link mconsole with ncurses (closes: #646162). Thanks to Sven Joachim + for the bug report and the patch. + + -- Jakub Wilk Wed, 02 Nov 2011 22:35:36 +0100 + +uml-utilities (20070815-1.2) unstable; urgency=low + + * Non-maintainer upload. + * Build-depend on libreadline-dev instead of libreadline5-dev + (closes: #553868). Thanks to Matthias Klose for the bug report. + * Remove Stefano Melchior from uploaders (closes: #514666 ). Thanks to + Sandro Tosi for the bug report. + + -- Jakub Wilk Sun, 07 Aug 2011 14:21:01 +0200 + +uml-utilities (20070815-1.1) unstable; urgency=low + + * Non-maintainer upload. + * Fixed dependency information in LSB header in init.d script + (closes: #470775) + + -- Peter Eisentraut Sat, 05 Apr 2008 14:59:53 +0200 + +uml-utilities (20070815-1) unstable; urgency=low + + * New upstream version (Closes: #438457) (Closes: #393263) + [Stefano Melchior] + * added the humfsify man page + * added the uml_mount man page + * updated policy version in debian/control + * added correction in the tunctl man page (Closes: #395020) + * added LSB support with patch from David Härdeman (Closes: #385906) + [Mattia Dongili]: + * Remove obsolete MAKEDEV invocation and udev/makedev dependencies + (Closes: #434161) + * Create /var/run/uml-utilities if it doesn't exist at uml_switch startup + (Closes: #434784) + * set a decent name for the _maintenance_ team. + * add UML_SWITCH_CTL to defaults file for easier customization. + * add uml_mkcow and jail_uml manpages. + * mention COW files advantages and how to see their actual + disk usage in uml_moo and uml_mkcow manpages. (Closes: #173302) + + -- Mattia Dongili Sun, 19 Aug 2007 15:39:38 +0900 + +uml-utilities (20060323-3) unstable; urgency=low + + [Mattia Dongili]: + * Install port-helper in the correct location (Closes: #362058). + * Cleaned up debian/rules and merged all install path stuff in a single + patch to upstream sources. + + -- Mattia Dongili Wed, 12 Apr 2006 22:32:53 +0200 + +uml-utilities (20060323-2) unstable; urgency=low + + * fix FTBFS on ia64 and alpha (spotted before the bug was delivered). + + -- Mattia Dongili Sun, 09 Apr 2006 22:39:15 +0200 + +uml-utilities (20060323-1) unstable; urgency=low + + [Mattia Dongili]: + * moved Stefano Melchior to Uploaders and using pkg-uml-pkgs@l.a.d.o as + Maintainer. + * added myself and Andreas Schuldei as Uploaders. + * uml_router vanished together with the core file in uptream source + package. (Closes: #280392) + * remove dpkg-statoverride entry on remove/purge of the package. + (Closes: #270680) + * provide an option to prevent uml_switch from starting. (Closes: #231265) + * some debian/rules cleanup and a non-POSIX shell code fix. + * converted changelog to UTF8. + + -- Mattia Dongili Sat, 08 Apr 2006 18:58:22 +0200 + +uml-utilities (20060110-1) unstable; urgency=low + + * Fixed libreadline5-dev build dependency (closes: #326287) + * Fixed space left on daemon stoping from Loic Minier > (closes: #236467) + + -- Stefano Melchior Wed, 11 Jan 2006 00:25:40 +0100 + +uml-utilities (20040406-1) unstable; urgency=low + + * New upstream release + * Patch from Carlos Perelló Marín to fix uml_proxy_arp with multiple + addresses (Closes: #243834) + + -- Matt Zimmerman Wed, 14 Apr 2004 17:59:45 -0700 + +uml-utilities (20040114-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Mon, 16 Feb 2004 23:01:35 -0800 + +uml-utilities (20030903-7) unstable; urgency=low + + * Add a note about using dhcpd to README.Debian + * Patch from Clint Adams to support multiple + proxy_arp addresses in /etc/network/interfaces (Closes: #222014) + + -- Matt Zimmerman Sun, 11 Jan 2004 22:52:13 -0800 + +uml-utilities (20030903-6) unstable; urgency=low + + * Documentation improvements to reflect user feedback + * Add some comments to interfaces.example explaining how they are used + * Add "ifup tap0" in the step-by-step instructions in README.Debian + * Clarify the README.Debian to indicate that there are multiple methods + of networking being documented + + -- Matt Zimmerman Fri, 19 Sep 2003 01:02:23 -0400 + +uml-utilities (20030903-5) unstable; urgency=low + + * Fix typo in daemon transport instructions in README.Debian + (Closes: #209250) + + -- Matt Zimmerman Wed, 17 Sep 2003 16:40:08 -0400 + +uml-utilities (20030903-4) unstable; urgency=low + + * Oops, the switch socket needs to be writable and executable as well. + This means the chmod is back. + + -- Matt Zimmerman Sat, 6 Sep 2003 12:37:59 -0400 + +uml-utilities (20030903-3) unstable; urgency=low + + * Don't chgrp/chmod the uml_switch socket. uml_switch is now a public + service to local users and requires no additional privileges. + (Closes: #208770) + * Add documentation to README.Debian about the uml_switch setup + + -- Matt Zimmerman Fri, 5 Sep 2003 20:13:59 -0400 + +uml-utilities (20030903-2) unstable; urgency=low + + * Use sysconf rather than PAGE_SIZE in uml_mkcow (Closes: #208795) + + -- Matt Zimmerman Fri, 5 Sep 2003 13:06:21 -0400 + +uml-utilities (20030903-1) unstable; urgency=low + + * New upstream release + * Update uml_mconsole(1) to document all commands. Added documentation + for cad, sysrq, stop, go and log. + * Update init script to match new uml_switch syntax + + -- Matt Zimmerman Thu, 4 Sep 2003 16:55:26 -0400 + +uml-utilities (20030605-5) unstable; urgency=low + + * Tweak interfaces example to use uml-net user, as an example of how to + let uml_switch connect to the tap interface + * I give up, invoke adduser with --no-create-home. Why should system + users have home directories in /home by default? (Closes: #208351) + * Don't let the init script fail if the uml-net user does not exist, + since that could have failed in postinst + + -- Matt Zimmerman Tue, 2 Sep 2003 19:20:19 -0400 + +uml-utilities (20030605-4) unstable; urgency=low + + * Update uml_switch man page to include new options -tap, -daemon, + -compat-v0 + * Add an init script which automatically starts up a uml_switch daemon, + which will be accessible by all users in the uml-net group + + -- Matt Zimmerman Mon, 1 Sep 2003 14:02:30 -0400 + +uml-utilities (20030605-3) unstable; urgency=medium + + * Depends: makedev (>= 2.3.1-62), as that is when tun support was + added (Closes: #204520) + * Include if-pre-up.d and if-up.d scripts and example + /etc/network/interfaces from Clint Adams + (Closes: #196523) + + -- Matt Zimmerman Sat, 16 Aug 2003 16:13:43 -0400 + +uml-utilities (20030605-2) unstable; urgency=low + + * Add explanation of uml_net location to README.Debian + * Depends: adduser (Closes: #201188) + + -- Matt Zimmerman Mon, 14 Jul 2003 08:57:33 -0400 + +uml-utilities (20030605-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Sat, 7 Jun 2003 00:06:09 -0400 + +uml-utilities (20030312-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Fri, 14 Mar 2003 21:38:11 -0500 + +uml-utilities (20030205-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Thu, 6 Feb 2003 22:56:55 -0500 + +uml-utilities (20030202-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Sun, 2 Feb 2003 20:25:13 -0500 + +uml-utilities (20030122-2) unstable; urgency=low + + * Actually create the tun device (changelog error) + + -- Matt Zimmerman Tue, 28 Jan 2003 01:13:30 -0500 + +uml-utilities (20030122-1) unstable; urgency=low + + * New upstream release + * Depends on makedev >= 2.3.1-62 and create tun device in postinst + (Closes: #174730) + + -- Matt Zimmerman Mon, 27 Jan 2003 12:22:19 -0500 + +uml-utilities (20021102-1) unstable; urgency=low + + * New upstream release + * Fixes a data corruption bug in uml_moo + * Use getent rather than sg to check for the existence of uml-net + + -- Matt Zimmerman Sun, 3 Nov 2002 15:26:21 -0500 + +uml-utilities (20020906-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Sat, 14 Sep 2002 12:01:13 -0400 + +uml-utilities (20020821-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Tue, 3 Sep 2002 16:38:07 -0400 + +uml-utilities (20020729-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Mon, 29 Jul 2002 21:01:57 -0400 + +uml-utilities (20020718-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Thu, 18 Jul 2002 22:51:28 -0400 + +uml-utilities (20020707-1) unstable; urgency=low + + * New upstream release + - Fixes large file handling in uml_moo (Closes: #146395) + - Provides a destructive merge option for uml_moo (Closes: #146399) + + -- Matt Zimmerman Mon, 8 Jul 2002 19:45:33 -0400 + +uml-utilities (20020604-1) unstable; urgency=low + + * New upstream release + * Includes uml_watchdog + + -- Matt Zimmerman Wed, 5 Jun 2002 21:19:20 -0400 + +uml-utilities (20020521-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Tue, 21 May 2002 20:39:40 -0400 + +uml-utilities (20020428-2) unstable; urgency=low + + * Use #ifdef around use of SA_NOCLDWAIT to allow building on ia64 again + (Closes: #145409) + + -- Matt Zimmerman Thu, 2 May 2002 16:14:42 -0400 + +uml-utilities (20020428-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Sun, 28 Apr 2002 23:03:05 -0400 + +uml-utilities (20020427-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Sat, 27 Apr 2002 15:46:25 -0400 + +uml-utilities (20020415-3) unstable; urgency=high + + * Aaarrgghh...forgot to change back to Architecture: any + + -- Matt Zimmerman Thu, 25 Apr 2002 22:22:36 -0400 + +uml-utilities (20020415-2) unstable; urgency=low + + * Hack debian/rules to avoid building or installing tunctl on arm + (Closes: #142740) + + -- Matt Zimmerman Sun, 21 Apr 2002 23:32:33 -0400 + +uml-utilities (20020415-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Sun, 21 Apr 2002 23:08:20 -0400 + +uml-utilities (20020410-1) unstable; urgency=low + + * New upstream release + + -- Matt Zimmerman Wed, 10 Apr 2002 23:06:38 -0400 + +uml-utilities (20020407-1) unstable; urgency=low + + * New upstream release + * Needed for 2.4.18-15um + + -- Matt Zimmerman Tue, 9 Apr 2002 00:47:18 -0400 + +uml-utilities (20020320-3) unstable; urgency=high + + * Limit architectures to everything except ARM in hopes of getting into + testing (and getting user-mode-linux 2.4.18 there). No other changes + whatsoever. + + -- Matt Zimmerman Sun, 7 Apr 2002 17:57:08 -0400 + +uml-utilities (20020320-2) unstable; urgency=low + + * Update tunctl(1) to reflect new syntax (Closes: #140702) + * Add README.Debian which briefly explains about access control for + virtual networking + + -- Matt Zimmerman Tue, 2 Apr 2002 08:55:55 -0500 + +uml-utilities (20020320-1) unstable; urgency=low + + * New upstream release. + + -- Matt Zimmerman Thu, 21 Mar 2002 22:24:21 -0500 + +uml-utilities (20020318-1) unstable; urgency=low + + * New upstream release. + * The uml_switch protocol has changed, and this version is required for + 2.4.18-8um + * libuml-perl is gone, superseded by the UML test suite tarball which is + not packaged yet + * Only suggest user-mode-linux (Closes: #137990) + + -- Matt Zimmerman Tue, 19 Mar 2002 08:44:43 -0500 + +uml-utilities (20020212-2) unstable; urgency=low + + * Remove uml_mkdebianfs. It was a quick hack, and not terribly useful. + Instead, use rootstrap, which is now in unstable. It is much more + feature-rich, configurable and extensible. + * Removal of uml_mkdebianfs Closes: #134635 + * Create a group for users authorized to run uml_net as root. If you + want this to be different, use dpkg-statoverride. (Closes: #136219) + + -- Matt Zimmerman Sat, 9 Mar 2002 17:57:41 -0500 + +uml-utilities (20020212-1) unstable; urgency=low + + * New upstream release. + * Includes a new tool, tunctl + + -- Matt Zimmerman Tue, 12 Feb 2002 22:59:51 -0500 + +uml-utilities (20020125-1) unstable; urgency=low + + * New upstream release. + * Include my simplistic uml_mkdebianfs script for building Debian root + images for UML + + -- Matt Zimmerman Fri, 25 Jan 2002 22:20:37 -0500 + +uml-utilities (20020104-2) unstable; urgency=medium + + * Remove reference to nonexistent uml_net(1) from uml_switch(1) + * Only Recommend user-mode-linux, don't depend on it. This is necessary + if we ever want to make it into testing. + + -- Matt Zimmerman Mon, 14 Jan 2002 19:05:27 -0500 + +uml-utilities (20020104-1) unstable; urgency=low + + * New upstream release. + * Should now handle version 2 COW files correctly (Closes: #123868) + + -- Matt Zimmerman Fri, 4 Jan 2002 20:01:18 -0500 + +uml-utilities (20011227-1) unstable; urgency=low + + * New upstream release. + + -- Matt Zimmerman Sat, 29 Dec 2001 18:35:07 -0500 + +uml-utilities (20011210-1) unstable; urgency=low + + * New upstream release. + * Add depends: libexpect-perl for libuml-perl + + -- Matt Zimmerman Wed, 12 Dec 2001 19:18:55 -0500 + +uml-utilities (20011209-2) unstable; urgency=low + + * Package UML.pm in new binary package libuml-perl + * Fix an error in the (Debian-only) security fix to uml_net + (Closes: #123643) + * Add missing build-dep on libreadline-dev (Closes: #123647) + + -- Matt Zimmerman Wed, 12 Dec 2001 18:47:29 -0500 + +uml-utilities (20011209-1) unstable; urgency=low + + * New upstream release. + * Includes security fixes + + -- Matt Zimmerman Sun, 9 Dec 2001 19:30:43 -0500 + +uml-utilities (20011124-2) unstable; urgency=low + + * Apply security fixes to uml_net (also sent upstream) + * Ship uml_net setuid root, so that virtual networking works for + unprivileged users. dpkg-statoverride it if you don't want this. + + -- Matt Zimmerman Sun, 9 Dec 2001 07:04:39 -0500 + +uml-utilities (20011124-1) unstable; urgency=low + + * Initial Release. + + -- Matt Zimmerman Wed, 5 Dec 2001 07:46:29 -0500 + + --- uml-utilities-20070815.orig/debian/compat +++ uml-utilities-20070815/debian/compat @@ -0,0 +1 @@ +4 --- uml-utilities-20070815.orig/debian/control +++ uml-utilities-20070815/debian/control @@ -0,0 +1,22 @@ +Source: uml-utilities +Section: otherosfs +Priority: extra +Maintainer: User Mode Linux Maintainers +Uploaders: Andreas Schuldei , Mattia Dongili +Build-Depends: debhelper (>> 4.0.0), libreadline-dev, docbook-to-man, dpatch, libfuse-dev +Standards-Version: 3.7.2 + +Package: uml-utilities +Architecture: linux-any +Depends: adduser, ${shlibs:Depends}, lsb-base (>= 3.0-10) +Suggests: user-mode-linux +Description: User-mode Linux (utility programs) + User-mode Linux is a port of the Linux kernel to its own system call + interface. It provides a kind of virtual machine, which runs Linux + as a user process under another Linux kernel. This is useful for + kernel development, sandboxing, jailing, experimentation, and + many other things. + . + This package contains userspace utilities for use with User-mode + Linux, including uml_mconsole, uml_moo, uml_switch, uml_net and + tunctl. --- uml-utilities-20070815.orig/debian/copyright +++ uml-utilities-20070815/debian/copyright @@ -0,0 +1,15 @@ +This package was debianized by Matt Zimmerman on +Wed, 5 Dec 2001 07:46:29 -0500. + +It was downloaded from http://user-mode-linux.sourceforge.net/ + +Upstream Author: Jeff Dike + +Copyright (from */*.c): + +/* Copyright 2001 Jeff Dike and others + * Licensed under the GPL + */ + +On Debian systems, a copy of the GNU General Public License (GPL) may +be found in /usr/share/common-licenses/GPL. --- uml-utilities-20070815.orig/debian/humfsify.sgml +++ uml-utilities-20070815/debian/humfsify.sgml @@ -0,0 +1,194 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + --> + + + Stefano"> + Melchior"> + + October 26, 2006"> + + 1"> + stefano.melchior@openlabs.it"> + + HUMFSIFY"> + + + Debian GNU/Linux"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2006 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + convert a directory to the format needed by the UML + humfs file system + + + + &dhpackage; + user + group + size + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + Instead, it has documentation in HTML format; see below. + + &dhpackage; is a Perl script necessary to + convert a directory to a format expected by the UML humfs file system. + + + + + HISTORY + UMLFS was born with the idea to substitute the Hostfs + implementation with a proper one for the UML purpose: when you + manage files with Hostfs within UML you need to work with + two different permission layers (the Host one and the UML one), + which have different ideas of ownerships. + This becomes evident when you need to + create a file as a non-root user on UML: you first need to interact + with the UML file system implementation, and then with the host side. + The result of a file creation on a mounted hostfs file system + is not what you expected: you can see that the file permissions refer to + the Host side user rather than the UML creator. + The Host side user is to be intended as the UML instance + launcher, meanwhile the UML side user is the one you used to log in + the UML instance. + You can encounter a more-critical problem when creating a + device node, operation that usually requires root privileges: you + used a common user to launch the UML and, since the operation is + done on the Host, it fails, even if you logged in as root. + Thus you need a set of tools which requires to bypass the + Hostfs permission checks on the Host side: this is done by + separating the file permissions and the ownership from the host's + files. This is the concept behind the HumFs and its &dhpackage; + implementation. + + + ARGUMENTS + + + + + + This is the user that needs to 'convert' a directory to the UML + file system to use UML. This is the host user who + will be using this filesystem from within UML. It + may be specified as either a user name or a numeric + user id. + + + + + + This is the group which your UML user belongs to. + This may be either a group name or a numeric group id + + + + + + This is the size of the file system as seen within the + UML instance. It must be expressed in Gigabytes ("G"), + Megabytes ("M"), or KiloBytes ("K"). + + + + + + + EXAMPLES + Create a directory on the host and mount it with &dhpackage; + host% mkdir your-humfs-dir + host% cd humfs-dir + + Within this directory create a new one where you would like to have + a UML-like hierarchy, i.e. you can loop-mount an UML rootfs + host% mkdir dir-to-be-humsified + host# mount -o loop rootfs /mnt + host% cp -a /mnt dir-to-be-humsified/data + host# &dhpackage; user group 512M + + Then verify it on UML and mount the humfsified + directory: + UML# mount none /your-uml-host -t humfs -o + .../dir-to-be-humfsified + where '/your-uml-mount-point' is the mount point on UML for + the humfsified file system, and .../dir-to-be-humfsified is + the humfsified directory in the example above. The '-t' mount option + specifies that the file system is to be mounted as 'humfs'. + + + + SEE ALSO + + The HostFs usage explanation within the + User-Mode-Linux Web Site + + + AUTHOR + + &dhpackage; was written by Jeff Dike. + + This manual page was written by &dhusername; &dhemail; for + the &debian; system, based on material in the Official User Mode + Linux Web Site. + + + + + --- uml-utilities-20070815.orig/debian/interfaces.example +++ uml-utilities-20070815/debian/interfaces.example @@ -0,0 +1,19 @@ +# Use this stanza if you want to configure an interface to connect +# the uml_switch daemon to the host via a tap interface +auto tap0 +iface tap0 inet static + address 192.168.1.1 + netmask 255.255.255.0 + tunctl_user uml-net + +# This is an example of how to set up a tap device for a particular +# user to use, with an IP address on the local network (eth0) via +# proxy ARP +auto tap1 +iface tap1 inet static + address 192.168.1.1 + netmask 255.255.255.255 + tunctl_user omega + uml_proxy_arp 192.168.100.52 + #uml_proxy_arp 192.168.100.52 192.168.100.53 192.168.100.54 + uml_proxy_ether eth0 --- uml-utilities-20070815.orig/debian/jail_uml.sgml +++ uml-utilities-20070815/debian/jail_uml.sgml @@ -0,0 +1,119 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + --> + + + Mattia"> + Dongili"> + + June 3, 2006"> + + 1"> + malattia@debian.org"> + + JAIL_UML"> + + + Debian GNU/Linux"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2006 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + run UML in a chroot-jail + + + + &dhpackage; + jail-directory + user + uml-command-line + + + &dhpackage; + jail-directory + uid + uml-command-line + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + Instead, it has documentation in HTML format; see below. + + &dhpackage; is a small utility to run + UML in a jailed chroot as the user user or with id + uid. + + When user does not exist it will be + assumed to be an uid. + + + + + SEE ALSO + + The UserModeLinux-HOWTO + + + AUTHOR + + This manual page was written by &dhusername; &dhemail; for + the &debian; system, based on the command help and sources. + + + + + + --- uml-utilities-20070815.orig/debian/patches/00list +++ uml-utilities-20070815/debian/patches/00list @@ -0,0 +1,2 @@ +02_fix_install_directories.dpatch +03_dont_link_against_ncurses.dpatch --- uml-utilities-20070815.orig/debian/patches/02_fix_install_directories.dpatch +++ uml-utilities-20070815/debian/patches/02_fix_install_directories.dpatch @@ -0,0 +1,63 @@ +#! /bin/sh /usr/share/dpatch/dpatch-run +## 02_fix_install_directories - Mattia Dongili +## +## All lines beginning with `## DP:' are a description of the patch. +## DP: Use Debian's multiarch directories + +@DPATCH@ + +# Author: malattia +# Status: none + +--- ./Makefile~clean 2006-04-12 22:27:54.083257719 +0200 ++++ ./Makefile 2006-04-12 22:28:04.119884969 +0200 +@@ -6,11 +6,7 @@ UMLVER = $(shell date +%Y%m%d) + TARBALL = uml_utilities_$(UMLVER).tar.bz2 + BIN_DIR = /usr/bin + +-ifeq ($(shell uname -m),x86_64) +-LIB_DIR = /usr/lib64/uml +-else + LIB_DIR = /usr/lib/uml +-endif + + CFLAGS = -g -Wall + #CFLAGS = -g -O2 -Wall +--- ./uml_net/Makefile~clean 2006-04-13 20:36:20.910393394 +0200 ++++ ./uml_net/Makefile 2006-04-13 20:36:42.763759144 +0200 +@@ -4,8 +4,6 @@ BIN = uml_net + CFLAGS ?= -g -Wall + override CFLAGS += $(TUNTAP) + +-BIN_DIR ?= /usr/bin +- + OBJS = ethertap.o host.o output.o slip.o uml_net.o + + ifneq ($(TUNTAP),) +@@ -21,5 +19,5 @@ clean : + rm -f $(BIN) $(OBJS) *~ + + install : $(BIN) +- install -d $(DESTDIR)$(BIN_DIR) +- install -s -m 04755 $(BIN) $(DESTDIR)$(BIN_DIR) ++ install -d $(DESTDIR)$(LIB_DIR) ++ install -s -m 04755 $(BIN) $(DESTDIR)$(LIB_DIR) +--- ./tunctl/Makefile~clean 2006-04-13 20:48:45.300914894 +0200 ++++ ./tunctl/Makefile 2006-04-13 20:49:08.218347144 +0200 +@@ -2,7 +2,7 @@ OBJS = tunctl.o + BIN = tunctl + CFLAGS ?= -g -Wall + +-BIN_DIR ?= /usr/bin ++SBIN_DIR ?= /usr/sbin + + all : $(BIN) + +@@ -13,5 +13,5 @@ clean : + rm -f $(BIN) $(OBJS) *~ + + install : $(BIN) +- install -d $(DESTDIR)$(BIN_DIR) +- install -s $(BIN) $(DESTDIR)$(BIN_DIR) ++ install -d $(DESTDIR)$(SBIN_DIR) ++ install -s $(BIN) $(DESTDIR)$(SBIN_DIR) --- uml-utilities-20070815.orig/debian/patches/03_dont_link_against_ncurses.dpatch +++ uml-utilities-20070815/debian/patches/03_dont_link_against_ncurses.dpatch @@ -0,0 +1,19 @@ +#! /bin/sh /usr/share/dpatch/dpatch-run +## 04_dont_link_against_ncurses.dpatch by Sven Joachim +## +## All lines beginning with `## DP:' are a description of the patch. +## DP: Do not unnecessarily link against ncurses + +@DPATCH@ +diff -urNad '--exclude=CVS' '--exclude=.svn' '--exclude=.git' '--exclude=.arch' '--exclude=.hg' '--exclude=_darcs' '--exclude=.bzr' uml-utilities-20070815~/mconsole/Makefile uml-utilities-20070815/mconsole/Makefile +--- uml-utilities-20070815~/mconsole/Makefile 2006-02-27 21:03:01.000000000 +0100 ++++ uml-utilities-20070815/mconsole/Makefile 2011-10-30 21:18:52.820631690 +0100 +@@ -1,7 +1,7 @@ + BIN = uml_mconsole + OBJS = $(BIN).o + CFLAGS ?= -g -Wall +-LIBS = ../lib/libuml.a -lreadline -lncurses ++LIBS = ../lib/libuml.a -lreadline + + BIN_DIR ?= /usr/bin + --- uml-utilities-20070815.orig/debian/postinst +++ uml-utilities-20070815/debian/postinst @@ -0,0 +1,59 @@ +#! /bin/sh + +set -e + +# summary of how this script can be called: +# * `configure' +# * `abort-upgrade' +# * `abort-remove' `in-favour' +# +# * `abort-deconfigure' `in-favour' +# `removing' +# +# for details, see http://www.debian.org/doc/debian-policy/ or +# the debian-policy package +# +# quoting from the policy: +# Any necessary prompting should almost always be confined to the +# post-installation script, and should be protected with a conditional +# so that unnecessary prompting doesn't happen if a package's +# installation fails and the `postinst' is called with `abort-upgrade', +# `abort-remove' or `abort-deconfigure'. + +case "$1" in + configure) + + if ! getent passwd uml-net >/dev/null; then + if getent group uml-net >/dev/null; then + # earlier versions only created a group + adduser --quiet --system --ingroup uml-net --no-create-home uml-net + else + adduser --quiet --system --group --no-create-home uml-net + fi + fi + + if ! dpkg-statoverride --list /usr/lib/uml/uml_net >/dev/null; then + dpkg-statoverride --update --add root uml-net 04750 \ + /usr/lib/uml/uml_net + fi + + ;; + + abort-upgrade|abort-remove|abort-deconfigure) + + ;; + + *) + echo "postinst called with unknown argument \`$1'" >&2 + exit 1 + ;; +esac + +# dh_installdeb will replace this with shell code automatically +# generated by other debhelper scripts. + +#DEBHELPER# + +exit 0 + + --- uml-utilities-20070815.orig/debian/postrm +++ uml-utilities-20070815/debian/postrm @@ -0,0 +1,48 @@ +#! /bin/sh +# postrm script for uml-utilities +# +# see: dh_installdeb(1) + +set -e + +# summary of how this script can be called: +# * `remove' +# * `purge' +# * `upgrade' +# * `failed-upgrade' +# * `abort-install' +# * `abort-install' +# * `abort-upgrade' +# * `disappear' overwrit>r> +# for details, see http://www.debian.org/doc/debian-policy/ or +# the debian-policy package + + +case "$1" in + purge|remove|abort-install) + if dpkg-statoverride --list /usr/lib/uml/uml_net >/dev/null; then + dpkg-statoverride --remove /usr/lib/uml/uml_net + fi + ;; + + upgrade|failed-upgrade|abort-upgrade|disappear) + # do nothing + ;; + + *) + echo "postrm called with unknown argument \`$1'" >&2 + exit 1 + ;; +esac + +if [ "${1}" = "purge" ] ; then + rm -rf /var/run/uml-utilities +fi + +# dh_installdeb will replace this with shell code automatically +# generated by other debhelper scripts. + +#DEBHELPER# + +exit 0 + --- uml-utilities-20070815.orig/debian/rules +++ uml-utilities-20070815/debian/rules @@ -0,0 +1,98 @@ +#!/usr/bin/make -f +# Sample debian/rules that uses debhelper. +# GNU copyright 1997 to 1999 by Joey Hess. + +# Uncomment this to turn on verbose mode. +#export DH_VERBOSE=1 + +# This is the debhelper compatability version to use. +export DEB_BUILD_ARCH?=$(shell dpkg-architecture -qDEB_BUILD_ARCH) + +tmp:=$(CURDIR)/debian/uml-utilities + +patch: patch-stamp +patch-stamp: + dpatch apply-all + touch $@ + +unpatch: + dpatch deapply-all + rm -rf debian/patched + rm -f patch-stamp + +configure: configure-stamp +configure-stamp: patch-stamp + dh_testdir + touch configure-stamp + +build: configure-stamp build-stamp +build-stamp: + dh_testdir + +ifeq "$(DEB_BUILD_ARCH)" "arm" + touch tunctl/tunctl +endif + $(MAKE) + + for man in debian/*.sgml; do \ + docbook-to-man $$man > `dirname $$man`/`basename $$man .sgml`.1; \ + done + + touch build-stamp + +clean: clean-unpatched +clean-unpatched: unpatch + dh_testdir + dh_testroot + rm -f build-stamp configure-stamp + + $(MAKE) clean + rm -f debian/*.1 + + dh_clean + +install: build + dh_testdir + dh_testroot + dh_clean -k + dh_installdirs usr/sbin usr/lib/uml \ + etc/network/if-up.d etc/network/if-pre-up.d + + $(MAKE) install DESTDIR=$(tmp) + + install -m 755 debian/uml-utilities.if-up.d $(tmp)/etc/network/if-up.d/uml-utilities + install -m 755 debian/uml-utilities.if-pre-up.d $(tmp)/etc/network/if-pre-up.d/uml-utilities + +ifeq "$(DEB_BUILD_ARCH)" "arm" + rm -f $(tmp)/usr/sbin/tunctl +endif + +# Build architecture-independent files here. +binary-indep: build install + +# Build architecture-dependent files here. +binary-arch: build install + dh_testdir -a + dh_testroot -a +# dh_installdebconf -a + dh_installdocs -a + dh_installexamples -a +# dh_installmenu -a +# dh_installlogrotate -a + dh_installinit -a + dh_installman -a debian/*.1 + dh_installinfo -a +# dh_undocumented + dh_installchangelogs -a + dh_link -a + dh_strip -a + dh_compress -a + dh_fixperms -a + dh_installdeb -a + dh_shlibdeps -a + dh_gencontrol -a + dh_md5sums -a + dh_builddeb -a + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install configure --- uml-utilities-20070815.orig/debian/tunctl.sgml +++ uml-utilities-20070815/debian/tunctl.sgml @@ -0,0 +1,164 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + --> + + + Matt"> + Zimmerman"> + + February 12, 2002"> + + 8"> + mdz@debian.org"> + + TUNCTL"> + + + Debian GNU/Linux"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2001 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + create and manage persistent TUN/TAP interfaces + + + + + &dhpackage; + + tun-clone-device + + owner + device-name + + + + + &dhpackage; + + tun-clone-device + device-name + + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + Instead, it has documentation in HTML format; see below. + + &dhpackage; allows the host sysadmin to + preconfigure a TUN/TAP device for use by a particular user. That + user may open and use the device, but may not change any aspects + of the host side of the interface. + + + + + USAGE + + To create an interface for use by a particular user, invoke + tunctl without the -d option: + + + + # tunctl -u someuser + + Set 'tap0' persistent and owned by 'someuser' + + + + Then, configure the interface as normal: + + + + # ifconfig tap0 192.168.0.254 up + + # route add -host 192.168.0.253 dev tap0 + + # bash -c 'echo 1 > /proc/sys/net/ipv4/conf/tap0/proxy_arp' + + # arp -Ds 192.168.0.253 eth0 pub + + + + To delete the interface, use the -d option: + + + + # tunctl -d tap0 + + Set 'tap0' nonpersistent + + + + + + SEE ALSO + + The UserModeLinux-HOWTO + + + AUTHOR + + &dhpackage; was written by Jeff Dike + jdike@karaya.com + + This manual page was written by &dhusername; &dhemail; for + the &debian; system, based on examples from Jeff Dike. + + + + + --- uml-utilities-20070815.orig/debian/uml-utilities.default +++ uml-utilities-20070815/debian/uml-utilities.default @@ -0,0 +1,20 @@ +# Options to pass to uml_switch. + +# set to "false" if you want to prevent uml_switch from +# starting with SysV scripts in /etc/init.d +# UML_SWITCH_START="false" + +# For preconfigured tap setup, see +# /usr/share/doc/uml-utilities/examples/interfaces.example +#UML_SWITCH_OPTIONS="-tap tap0" + +# User as which to run uml_switch +#UML_SWITCH_USER="uml-net" + +# Socket file to use +# Debian's default is: +#UML_SWITCH_CTL="/var/run/uml-utilities/uml_switch.ctl" +# +# if you instead use your rolled up kernel from upstream +# sources you may want to uncomment the following: +#UML_SWITCH_CTL="/tmp/uml.ctl" --- uml-utilities-20070815.orig/debian/uml-utilities.examples +++ uml-utilities-20070815/debian/uml-utilities.examples @@ -0,0 +1,2 @@ +jail/tty_log.pl +debian/interfaces.example --- uml-utilities-20070815.orig/debian/uml-utilities.if-pre-up.d +++ uml-utilities-20070815/debian/uml-utilities.if-pre-up.d @@ -0,0 +1,12 @@ +#!/bin/sh + +test -x /usr/sbin/tunctl || exit 0 +test -n "${IF_TUNCTL_USER}" || exit 0 + +/usr/sbin/tunctl -u "${IF_TUNCTL_USER}" -t "${IFACE}" + +# +# why the hell does this need to be done? +# +chown root:uml-net /dev/net/tun +chmod 660 /dev/net/tun --- uml-utilities-20070815.orig/debian/uml-utilities.if-up.d +++ uml-utilities-20070815/debian/uml-utilities.if-up.d @@ -0,0 +1,12 @@ +#!/bin/sh + +test -n "${IF_UML_PROXY_ARP}" || exit 0 +test -n "${IF_UML_PROXY_ETHER}" || exit 0 + +sysctl -w net/ipv4/conf/"${IFACE}"/proxy_arp=1 + +for i in ${IF_UML_PROXY_ARP}; +do + route add -host "$i" dev "${IFACE}" + arp -Ds "$i" "${IF_UML_PROXY_ETHER}" pub +done --- uml-utilities-20070815.orig/debian/uml-utilities.init +++ uml-utilities-20070815/debian/uml-utilities.init @@ -0,0 +1,93 @@ +#! /bin/sh -e +# +### BEGIN INIT INFO +# Short-Description: start and stop UML networking services +# Description: uml-utilities provide some simple UML networking configuration services +# X-implementor: Matt Zimmerman +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Provides: uml-utilities +# Required-Start: $remote_fs +# Required-Stop: $remote_fs +### END INIT INFO + +# Start LSB function logging +. /lib/lsb/init-functions +DISTRO=$(lsb_release -is 2>/dev/null || echo Debian) + + +PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin +DAEMON=/usr/bin/uml_switch +NAME=uml_switch +DESC="User-mode networking switch" +UML_DIR=/var/run/uml-utilities +PIDFILE=$UML_DIR/$NAME.pid + +test -x $DAEMON || exit 0 + +UML_SWITCH_OPTIONS="" +UML_SWITCH_USER="uml-net" +UML_SWITCH_CTL="$UML_DIR/uml_switch.ctl" + +if [ -e /etc/default/uml-utilities ]; then + . /etc/default/uml-utilities +fi + +OPTIONS="$UML_SWITCH_OPTIONS -unix $UML_SWITCH_CTL" + +case "$1" in + start) + if [ "x$UML_SWITCH_START" = "xfalse" ] ; then + [ "$VERBOSE" = "yes" ] && log_warning_msg "$DESC disabled" + exit 0 + fi + # create $UML_DIR if it doesn't exist (RAMRUN=yes in /etc/default/rcS) + if [ ! -d "$UML_DIR" ] ; then + mkdir -p $UML_DIR + chown uml-net:uml-net $UML_DIR + fi + log_daemon_msg "Starting $DESC" "$NAME" + if ! start-stop-daemon --start --quiet --pidfile $PIDFILE \ + --make-pidfile --background --chuid $UML_SWITCH_USER \ + --exec $DAEMON -- $OPTIONS; then + log_end_msg 1 + exit 1 + fi + + WAIT=5 + while ! test -e $UML_SWITCH_CTL; do + sleep 1 + WAIT=$(($WAIT - 1)) + if [ $WAIT -le 0 ]; then + log_warning_msg "$DAEMON never created control socket $UML_SWITCH_CTL" + log_end_msg 1 + exit 1 + fi + done + + chmod 777 $UML_SWITCH_CTL + log_end_msg 0 + ;; + stop) + log_daemon_msg "Stopping $DESC" "$NAME" + if start-stop-daemon --stop --quiet --pidfile $PIDFILE \ + --oknodo --exec $DAEMON; then + rm -f $PIDFILE $UML_SWITCH_CTL $UML_SWITCH_DATA + log_end_msg 0 + else + log_end_msg 1 + fi + ;; + restart|force-reload) + $0 stop + $0 start + ;; + *) + N=/etc/init.d/$NAME + # echo "Usage: $N {start|stop|restart|reload|force-reload}" >&2 + echo "Usage: $N {start|stop|restart|force-reload}" >&2 + exit 1 + ;; +esac + +exit 0 --- uml-utilities-20070815.orig/debian/uml_mconsole.sgml +++ uml-utilities-20070815/debian/uml_mconsole.sgml @@ -0,0 +1,284 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + --> + + + Matt"> + Zimmerman"> + + December 5, 2001"> + + 1"> + mdz@debian.org"> + + UML_MCONSOLE"> + + + Debian GNU/Linux"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2001 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + attach to the management console of a user-mode Linux + kernel + + + + &dhpackage; + + socket + + command + + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + + &dhpackage; is a program to connect to + the management console of a user-mode Linux kernel. The UML + management console is a low-level interface to the kernel, + somewhat like the i386 SysRq interface. Since there is a + full-blown operating system under UML, there is much greater + flexibility possible than with the SysRq mechanism. + + + + OPTIONS + + + + socket + + The pathname of the socket to which to connect. This + is printed when UML boots, for example: + + mconsole initialized on /tmp/umlNJ32yL/mconsole + + + + In this example, you would start uml_mconsole like + this: + + uml_mconsole umlNJ32yL + + + + + + command + + Any of the commands listed in the + “COMMANDS” section. + + + + + + + COMMANDS + + + + version + + Prints the UML version number. + + + + + + + halt + + Shuts down the UML system immediately, without syncing + disks or cleanly shutting down swap space. + + + + + + + reboot + + Reboots the UML system immediately, without syncing + disks or cleanly shutting down swap space. + + + + + + + log string + + Cause UML to log string to + the kernel log. + + + + + + + cad + + Invokes the Control-Alt-Delete handler. + + + + + + + sysrq letter + + Performs the SysRq action controlled by + letter. + + + + + + + stop + + Pauses UML. UML will do nothing until the 'go' + command is issued. + + + + + + + go + + Resumes execution after a 'stop' command. + + + + + + + config + + Adds a new device to the virtual machine, or queries + the configuration of an existing device. It takes one + argument, which is either the device to add, with the same + syntax as the kernel command line, or the name of an + existing device. For example: + + + +(mconsole) config ubd3=root_fs_debian22 + +OK + + + + + +(mconsole) config ubd3 + +OK root_fs_debian22 + + + + + + + + + + remove + + Deletes a device from the virtual machine. Its + argument is the name of the device to be removed. In the + case of the ubd driver, the removed block device must not be + mounted, swapped on, or otherwise open, and in the case of + the network driver, the device must be down. + + + +(mconsole) remove ubd3 + +OK + + + + + + + + + + SEE ALSO + + linux(1) + + The UserModeLinux-HOWTO + + + AUTHOR + + &dhpackage; was written by Jeff Dike and others. + + This manual page was written by &dhusername; &dhemail; for + the &debian; system, based on material in the + UserModeLinux-HOWTO by Rusty Russell, and the uml_mconsole + source code. + + + + + --- uml-utilities-20070815.orig/debian/uml_mkcow.sgml +++ uml-utilities-20070815/debian/uml_mkcow.sgml @@ -0,0 +1,141 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + --> + + + Mattia"> + Dongili"> + + June 2, 2006"> + + 1"> + malattia@debian.org"> + + UML_MKCOW"> + + + Debian GNU/Linux"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2006 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + create a new COW file + + + + &dhpackage; + -f + COW_file + backing_file + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + Instead, it has documentation in HTML format; see below. + + &dhpackage; is a small utility to create + COW (Copy-On-Write) files without the need to run the full UML kernel. + + + NOTE: you can save a lot of disk space using COW files. + When checking the size of the COW file in order to see the gobs + of space that you're saving, make sure you use 'ls -ls' to see the actual + disk consumption rather than the length of the file. The COW file is + sparse, so the length will be very different from the disk usage. + + + + OPTIONS + + + + + + Force overwrite of an exsiting COW file. + + + + + + + EXAMPLES + + Create a new COW file: + &dhpackage; rootfs_COW rootfs + + Overwrite (destroying) an existing COW file: + &dhpackage; -f rootfs_COW rootfs + + + + + SEE ALSO + + The UserModeLinux-HOWTO + + + AUTHOR + + &dhpackage; was written by Steve Schnepp. + + This manual page was written by &dhusername; &dhemail; for + the &debian; system, based on material in the + UserModeLinux-HOWTO by Rusty Russell. + + + + + --- uml-utilities-20070815.orig/debian/uml_moo.sgml +++ uml-utilities-20070815/debian/uml_moo.sgml @@ -0,0 +1,121 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + --> + + + Matt"> + Zimmerman"> + + December 5, 2001"> + + 1"> + mdz@debian.org"> + + UML_MOO"> + + + Debian GNU/Linux"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2001 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + merge a COW file with its backing file + + + + &dhpackage; + + COW file + + new_backing_file + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + Instead, it has documentation in HTML format; see below. + + &dhpackage; is a program to merge a COW + (copy-on-write) file with its backing file, and write the result + to a new backing file. This can be used periodically to update + the backing file with the changes made in the COW file. + + NOTE: you can save a lot of disk space using COW files. + When checking the size of the COW file in order to see the gobs + of space that you're saving, make sure you use 'ls -ls' to see the actual + disk consumption rather than the length of the file. The COW file is + sparse, so the length will be very different from the disk usage. + + + + + SEE ALSO + + The UserModeLinux-HOWTO + + + AUTHOR + + &dhpackage; was written by RidgeRun,Inc + glonnon@ridgerun.com + + This manual page was written by &dhusername; &dhemail; for + the &debian; system, based on material in the + UserModeLinux-HOWTO by Rusty Russell. + + + + + --- uml-utilities-20070815.orig/debian/uml_mount.sgml +++ uml-utilities-20070815/debian/uml_mount.sgml @@ -0,0 +1,237 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + --> + + + Stefano"> + Melchior"> + + November 24, 2006"> + + 1"> + stefano.melchior@openlabs.it"> + + UML_MOUNT"> + + + Debian GNU/Linux"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2006 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + allows to mount UMLFS file system using the fuse libraries + + + + &dhpackage; + mount-point + options + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; command. + + This command uses the FUSE (File system in USErspace) + libraries and invokes the FUSE_MOUNT function which expects a mount + point and some parameters as arguments. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. For a + practical example, please refer to the link below. + + &dhpackage; is used to mount UMLFS file + system. + + + + ARGUMENTS + + + + + + This is the mount point where to mount the UMLFS file system + with. + + + + + + These are the other options accepted by the 'fuse_mount' + function. + + + + + + + General options: + + + + The "-h" option prints the help. + + + + + + The "-V" option prints the version. + + + + + + The "-o" option allows to provide further mount (only, + not un-mount) option(s) to the command line. + + + + + + + FUSE options: + + + + The "-d" option enable the debug output. It implies + "-f". + + + + + + The "-f" option foregrounds the operation. + + + + + + + The "-s" options disable multi-threaded operation. + + + + + + + The "-o allow_other" option allows access to other users. + + + + + + + The "-o allow_root" option allows access to root. + + + + + + + The "-o nonempty" option allows mounts over non-empty + file/dir. + + + + + + + The "-o default_permissions" enables permission checking + by kernel. + + + + + + + The "-o fsname=NAME" option sets file system name. + + + + + + + The "-o large_read" option issues large read requests + (2.4 only). + + + + + + + The "-o max_read=N" option sets the maximum size of read + requests. + + + + + + + SEE ALSO + + The HostFs usage explanation within the + User-Mode-Linux Web Site + + + AUTHOR + + &dhpackage; was written by Jeff Dike. + + This manual page was written by &dhusername; (&dhemail;) for + the &debian; system, based on material in the Official User Mode + Linux Web Site. + + + + + --- uml-utilities-20070815.orig/debian/uml_switch.sgml +++ uml-utilities-20070815/debian/uml_switch.sgml @@ -0,0 +1,165 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + --> + + + Matt"> + Zimmerman"> + + December 5, 2001"> + + 1"> + mdz@debian.org"> + + UML_SWITCH"> + + + Debian GNU/Linux"> + GNU"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2001 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + switch daemon for user-mode Linux + + + + &dhpackage; + control_socket data_socket + + + + + + + + DESCRIPTION + + This manual page documents briefly the + &dhpackage; program. + + This manual page was written for the &debian; distribution + because the original program does not have a manual page. + + &dhpackage; is a daemon for managing a + virtual network between user-mode Linux systems, with no + connection to the host system's network. + + It will listen for connections on a pair of UNIX domain + sockets, and forward packets between clients which connect to + them. + + + + OPTIONS + + + + + + Listen on the specified pair of sockets, instead of + the defaults. + + + + + + Act like a hub. This means that packets received will + be broadcast over all virtual links. The default is to act + as a switch, where packets are only sent to the link + matching the destination MAC address of the packet. + + + + + + Connect the switch to a dynamically created tap device + on the host + + + + + + Specify control protocol version 0 compatibility. + + + + + + Run in the background as a daemon. + + + + + + SEE ALSO + + linux(1) + + The UserModeLinux-HOWTO + + + + AUTHOR + + &dhpackage; was written by Jeff Dike and others. + + This manual page was written by &dhusername; &dhemail; for + the &debian; system (but may be used by others). Permission is + granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation + License, Version 1.1 or any later version published by the Free + Software Foundation; with no Invariant Sections, no Front-Cover + Texts and no Back-Cover Texts. + + + + +