projects
/
grml-debootstrap.git
/ commitdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
| commitdiff |
tree
raw
|
patch
|
inline
| side by side (parent:
de3e0da
)
Update docs to reflect recent development
author
Michael Prokop
<mika@grml.org>
Wed, 12 Nov 2008 11:53:26 +0000
(12:53 +0100)
committer
Michael Prokop
<mika@grml.org>
Wed, 12 Nov 2008 11:53:26 +0000
(12:53 +0100)
grml-debootstrap.8.txt
patch
|
blob
|
history
diff --git
a/grml-debootstrap.8.txt
b/grml-debootstrap.8.txt
index
1a0880f
..
a542304
100644
(file)
--- a/
grml-debootstrap.8.txt
+++ b/
grml-debootstrap.8.txt
@@
-31,29
+31,34
@@
CAUTION: The grml team does not take responsibility for loss of any data!
Options and environment variables
---------------------------------
Options and environment variables
---------------------------------
-*-h*, *--help*::
- Show summary of options and exit.
+*--boot_append* <_appendline for the kernel_>::
+ Specify appendline for the kernel.
+ E.g. "_pci=nomsi_"
-*-
v*, *--version*
::
-
Show version of program and exit
.
+*-
c*, *--config* <_file_>
::
+
Use specified configuration file, defaults to /etc/debootstrap/config
.
-*--grub* <_device_>::
- Where do you want to install grub to? Use grub syntax for specifying.
- Do not forget to set groot as well. Leave empty to avoid installation of grub.
+*-d*, *--confdir* <_path_>::
+ Place of configuration files for debootstrap, defaults to /etc/debootstrap.
+
+*--debconf* <_file_>::
+ Use specified file for preseeding Debian packages instead of using
+ the default <confdir>/debconf-selections.
*--groot* <_device_>::
Specify root device for usage in grub (corresponds with $TARGET).
Again, use grub syntax for specifying.
Corresponding with configuration variable GROOT.
*--groot* <_device_>::
Specify root device for usage in grub (corresponds with $TARGET).
Again, use grub syntax for specifying.
Corresponding with configuration variable GROOT.
-*--
boot_append* <_appendline for the kernel
_>::
-
Specify appendline for the kernel
.
- E.g. "_pci=nomsi_"
+*--
grub* <_device
_>::
+
Where do you want to install grub to? Use grub syntax for specifying
.
+ Do not forget to set groot as well. Leave empty to avoid installation of grub.
-*-m*, *--mirror* <_URL_>::
- Specify mirror which should be used for apt-get/aptitude. Notice that
- specifying the mirror also sets the chrootmirror to the given value.
- Corresponding with configuration variables MIRROR and CHROOTMIRROR.
+*--help*, *-h*::
+ Show summary of options and exit.
+
+*--hostname* <_hostname_>::
+ Use specified hostname instead of the default (being 'grml').
*-i*, *--iso* <_/mntpoint_>::
Specify mountpoint where you have a Debian ISO mounted loopback.
*-i*, *--iso* <_/mntpoint_>::
Specify mountpoint where you have a Debian ISO mounted loopback.
@@
-62,10
+67,22
@@
Options and environment variables
mounted the according Debian-ISO to the given <_/mntpoint_>. See section
'Usage examples' for a demonstration.
mounted the according Debian-ISO to the given <_/mntpoint_>. See section
'Usage examples' for a demonstration.
+*--keep_src_list*::
+ Do not overwrite user provided /etc/apt/sources.list.
+
+*-m*, *--mirror* <_URL_>::
+ Specify mirror which should be used for apt-get/aptitude. Notice that
+ specifying the mirror also sets the chrootmirror to the given value.
+ Corresponding with configuration variables MIRROR and CHROOTMIRROR.
+
*-p*, *--mntpoint* <_/mntpoint_>::
Specify mountpoint that should be used for mounting the target system.
Corresponding with configuration variable MNTPOINT.
*-p*, *--mntpoint* <_/mntpoint_>::
Specify mountpoint that should be used for mounting the target system.
Corresponding with configuration variable MNTPOINT.
+*--packages* <_file_>::
+ Use specified file as list for packages that should be installed instead of
+ the default package list file <confdir>/packages.
+
*--password* <_password_>::
Use specified password as password for user root. Use with caution, as your
commandline might be visible in the process list and the shell history.
*--password* <_password_>::
Use specified password as password for user root. Use with caution, as your
commandline might be visible in the process list and the shell history.
@@
-81,6
+98,12
@@
Options and environment variables
use a _device_ instead of a directory as _target_ (installation of
grub as bootloader when using directories isn't supported yet).
use a _device_ instead of a directory as _target_ (installation of
grub as bootloader when using directories isn't supported yet).
+*-v*, *--verbose*::
+ Increase verbosity.
+
+*-V*, *--version*::
+ Show version of program and exit.
+
WARNING: the commandline parsing of grml-debootstrap does not validate the provided
arguments for the commandline options. Please be careful and check docs and
/etc/debootstrap/config for further information.
WARNING: the commandline parsing of grml-debootstrap does not validate the provided
arguments for the commandline options. Please be careful and check docs and
/etc/debootstrap/config for further information.
@@
-88,15
+111,15
@@
arguments for the commandline options. Please be careful and check docs and
Usage examples
---------------
Usage examples
---------------
- grml-debootstrap --target /dev/
h
da1 --grub hd0 --groot hd0,0
+ grml-debootstrap --target /dev/
s
da1 --grub hd0 --groot hd0,0
-Install default Debian release (stable/etch) on /dev/
h
da1 and install bootmanager
-Grub in MBR (master boot record) of /dev/
hda and use /dev/h
da1 as system partition.
+Install default Debian release (stable/etch) on /dev/
s
da1 and install bootmanager
+Grub in MBR (master boot record) of /dev/
sda and use /dev/s
da1 as system partition.
- grml-debootstrap --target /dev/
h
da6 --grub hd0 --groot hd0,5 --release sid
+ grml-debootstrap --target /dev/
s
da6 --grub hd0 --groot hd0,5 --release sid
-Install Debian unstable/sid on /dev/
h
da6, install bootmanager
-Grub in MBR (master boot record) of /dev/
hda and use /dev/h
da6 as system partition.
+Install Debian unstable/sid on /dev/
s
da6, install bootmanager
+Grub in MBR (master boot record) of /dev/
sda and use /dev/s
da6 as system partition.
grml-debootstrap --target /data/chroot
grml-debootstrap --target /data/chroot
@@
-109,12
+132,12
@@
Install default Debian release (stable/etch) on /dev/sda3 and install bootmanage
Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.
Use specified mirror instead of the default (ftp://ftp.debian.de/debian) one.
Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.
Use specified mirror instead of the default (ftp://ftp.debian.de/debian) one.
- mount -o loop /mnt/
h
da6/debian-40r0-i386-CD-1.iso /mnt/iso
- grml-debootstrap --target /dev/
h
da1 --grub hd0 --groot hd0,0 --iso file:/mnt/iso/debian/
+ mount -o loop /mnt/
s
da6/debian-40r0-i386-CD-1.iso /mnt/iso
+ grml-debootstrap --target /dev/
s
da1 --grub hd0 --groot hd0,0 --iso file:/mnt/iso/debian/
-Install Debian stable/etch on /dev/
h
da1 using the loopback mounted Debian-ISO
+Install Debian stable/etch on /dev/
s
da1 using the loopback mounted Debian-ISO
for the base-system and install bootmanager Grub in MBR (master boot record) of
for the base-system and install bootmanager Grub in MBR (master boot record) of
-/dev/
hda and use /dev/h
da1 as system partition. Please notice, that the chroot
+/dev/
sda and use /dev/s
da1 as system partition. Please notice, that the chroot
system requires network access for all packages which are not part of the
ISO.
system requires network access for all packages which are not part of the
ISO.
@@
-184,7
+207,7
@@
mentioned above):
target=...
The target partition/directory of the new Debian system. Usage example:
target=...
The target partition/directory of the new Debian system. Usage example:
-target=/dev/
h
da1
+target=/dev/
s
da1
grub=...
grub=...
@@
-215,10
+238,10
@@
argument. Usage example: password=AiTh5ahn
Usage example for automatic installation:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Usage example for automatic installation:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- debian2hd target=/dev/
h
da1 grub=hd0 groot=hd0,0 mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar
+ debian2hd target=/dev/
s
da1 grub=hd0 groot=hd0,0 mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar
You have to enter this commandline at the bootprompt of grml. Please make sure
You have to enter this commandline at the bootprompt of grml. Please make sure
-that /dev/
h
da1 is the partition where you really want to install your new Debian
+that /dev/
s
da1 is the partition where you really want to install your new Debian
system.
[NOTE]
system.
[NOTE]
@@
-238,7
+261,7
@@
include::releasetable.txt[]
[1] Please notice that Sarge is the current old-stable within Debian.
grml-debootstrap can handle the release but you really should not
use Sarge anymore unless you really know what you are doing. Choose
[1] Please notice that Sarge is the current old-stable within Debian.
grml-debootstrap can handle the release but you really should not
use Sarge anymore unless you really know what you are doing. Choose
-Etch instead.
+Etch
or Lenny
instead.
=====================================================================
Bugs
=====================================================================
Bugs