home *** CD-ROM | disk | FTP | other *** search
/ Chip 2003 April / Chip_2003-04_cd1.bin / zkuste / mini / download / lnx-bbc-1.618.iso / CREDITS-README.txt < prev    next >
Encoding:
Text File  |  2001-08-15  |  15.2 KB  |  453 lines
  1.    Welcome to the LNX-BBC Version 1.618
  2.  
  3. Table of Contents
  4.      What is this thing for?
  5.      Copyright Notice
  6.      Using the LNX-BBC -- System Requirements:
  7.      Booting and logging in:
  8.      What else happens:
  9.      Shutting down the system:
  10.      Making devices (if necessary):
  11.      Creating recovery information for later use:
  12.      Restoring recovery information from your rescue floppy:
  13.      Mounting other filesystems
  14.      Using utilites to repair or recover data:
  15.      Getting networking to work:
  16.      Getting ssh to run:
  17.      Pcmcia:
  18.      Plug-n-play(tm):
  19.      Changes:
  20.      Installing Debian GNU/Linux to a hard drive:
  21.      Getting support:
  22.  
  23.    This document should give you most of what you need to get up and
  24.    running with the LNX-BBC system, and should provide some tips for
  25.    making it do useful things.
  26.  
  27. What is this thing for?
  28.  
  29.    Welcome to the LNX-BBC bootable CD system, version 1.618.  We've
  30.    provided a reasonably large set of applications that you can use to:
  31.  
  32.      * repair a broken system
  33.      * recover a lost system from backup
  34.      * save important information to a floppy
  35.      * boot any computer as a basic Linux system
  36.  
  37.    Traditionally, you could use software included here to
  38.  
  39.      * install the Debian GNU/Linux base system onto a computer's hard
  40.        drive
  41.  
  42.    This version has once again some support for installing Debian.
  43.    (See "README-DEBIAN" for more information.)
  44.  
  45.    First, some IMPORTANT information:
  46.  
  47.    NOTE: THIS CD-ROM IS FOR USE BY EXPERTS ONLY! YOU CAN REALLY DISABLE
  48.    YOUR SYSTEM AND CAUSE IRREPARABLE DATA LOSS BY USING THIS CD-ROM OR
  49.    ANY OF THE TOOLS ON IT ON YOUR COMPUTER. DON'T USE THIS DISK UNLESS
  50.    YOU REALLY REALLY KNOW WHAT YOU'RE DOING! READ AND ACCEPT THE TERMS
  51.    LISTED IN DISCLAIMER.txt BEFORE USING THIS DISK. DON'T RUN WITH
  52.    SCISSORS.
  53.  
  54. Copyright Notice
  55.  
  56.  
  57. Copyright (C) 1999, 2000, 2001 Linuxcare, Inc.
  58. Copyright (C) 2001 Tom Crimi, Duncan MacKinnon, Seth Schoen, Andrew Scott,
  59. and contributors
  60.  
  61. Compilation Copyright (C) 1999, 2000, 2001 Linuxcare, Inc.
  62. Compilation Copyright (C) 2001 Tom Crimi, Duncan MacKinnon, Seth Schoen,
  63. Andrew Scott and contributors.
  64.  
  65.      This document and this software compilation may be distributed
  66.      and/or modified under the terms of the GNU General Public License
  67.      as published by the Free Software Foundation; either version 2,
  68.      or (at your option) any later version.
  69.  
  70.  
  71.      You should have received a copy of the GPL in /GPL; you can also
  72.      obtain it by writing to the Free Software Foundation, Inc., 59
  73.      Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  74.  
  75.      Most of the software packages included in this compilation are
  76.      free software, distributed under the terms of their respective
  77.      licenses, allowing use, modification, and redistribution.  For
  78.      more information on the license terms of a particular program,
  79.      consult its source code or documentation.  (Note that copyright
  80.      holders and developers of this software provide no warranty of
  81.      non-infringement in connection with any particular software package.
  82.      It is your responsibility to ensure that your use of the software
  83.      is non-infringing.)
  84.  
  85.      The LNX-BBC Project provides the source code for all of the programs
  86.      contained herein.  Complete source code may be obtained at no
  87.      cost over the Internet; see
  88.               http://www.lnx-bbc.org/
  89.  
  90. The LNX-BBC system is based on the Linuxcare Bootable Business Card
  91. version 1.6.0.  LNX-BBC is an independent project not affiliated with
  92. Linuxcare.
  93.  
  94. Linuxcare is a service mark of Linuxcare, Inc., which does not endorse
  95. this distribution or any associated documentation.
  96.  
  97.  
  98. Using the LNX-BBC -- System Requirements:
  99.  
  100.      * An Intel x86 or compatible system with bootable CD-ROM
  101.      * 16 MB RAM or more
  102.      * Optional VGA monitor
  103.  
  104.    While we've had good results with some laptops, they present a number
  105.    of special challenges that we've chosen to avoid, like non-standard
  106.    CD-ROMs, USB floppies, and other weird components. If you can get your
  107.    Laptop to boot the LNX-BBC, great. We have now included basic PCMCIA
  108.    support; many, but not all, laptops will work, so please do not be
  109.    surprised if your laptop is incompatible.
  110.  
  111.    If you have a non-bootable IDE or PCI SCSI CD-ROM drive, but also have
  112.    a bootable 1.44 MB floppy drive, a blank floppy disk, and access to a
  113.    working computer system, you may still use this CD-ROM by writing
  114.    "lnx.img" onto a floppy and booting from that; see the README file on
  115.    the CD-ROM itself for details.
  116.  
  117. Booting and logging in:
  118.  
  119.    Place the CD-ROM into your CD-ROM drive. On most modern CD-ROM drives,
  120.    there is an indent for mini-CDs (also known as CD singles), and this
  121.    CD-ROM should fit perfectly into this groove.
  122.  
  123.    Start the computer. Make sure that your computer's BIOS places the
  124.    CD-ROM before any other device in the boot order.
  125.  
  126.    The system should boot up, go through its startup sequence, and bring
  127.    you to a login prompt. Follow the directions to log in. You've
  128.    arrived!
  129.  
  130. What else happens:
  131.  
  132.    All of the ext2 hard disk partitions get mounted, to /mnt/0, /mnt/1,
  133.    ... /mnt/10, /mnt/11, etc.
  134.  
  135.    This CD-ROM will be mounted on /mnt/cdrom; any other CD-ROMs will be
  136.    mounted as though they were hard disk partitions.
  137.  
  138.    All of the ext2 disk partitions get mounted READ-ONLY.
  139.  
  140.    # mount -o remount,rw PATH
  141.  
  142.    will make a particular filesystem writable, so that you can make
  143.    changes through the filesystem to the data on that partition. (Note
  144.    that low-level disk utilities which read and write raw devices can
  145.    always be used to modify a disk, regardless of whether or not its
  146.    partitions are mounted writable. You should of course understand that
  147.    fdisk can still write to and change a read only mounted file system)
  148.  
  149.    There are 4 virtual consoles enabled by default -- access them by
  150.    pressing ALT-F1 through ALT-F4. Log in as user "root", with password
  151.    "bbc".
  152.  
  153. Shutting down the system:
  154.  
  155.    When you're ready to shut down the system, type:
  156.  
  157.    # reboot
  158.  
  159.    Filesystems will be unmounted, and the system will reboot. (The
  160.    "shutdown" command on this CD-ROM is an alias for "reboot", and they
  161.    do the same thing.)
  162.  
  163. Making devices (if necessary):
  164.  
  165.    If you need to make a special device file that was not created by
  166.    default, use the MAKEDEV command in the /dev directory, like this:
  167.  
  168.    # cd /dev
  169.    # ./MAKEDEV devicename
  170.  
  171.    The "mknod" command is also available to allow you to create device
  172.    nodes for devices not known to the MAKEDEV script.
  173.  
  174.    There is also a script called "makedev" that attempts to create every
  175.    possible device node. This takes a significant amount of time and disk
  176.    space. (You will run out of inodes if you try to run this script in
  177.    the BBC's ramdisk. It might be most useful to use this script for
  178.    reference in order to look up how to create a particular device node.)
  179.  
  180. Creating recovery information for later use:
  181.  
  182.    One piece of information that you want to save is the contents of each
  183.    disk's partition table. It is usually contained on the first sector of
  184.    the each disk installed on your system. To save it, put a new floppy
  185.    in your computer. Type the following:
  186.  
  187.    # mke2fs /dev/fd0
  188.    # mkdir -p /mnt/floppy
  189.    # mount -t ext2 /dev/fd0 /mnt/floppy
  190.  
  191.    Then for each of your disks, such as /dev/hda, /dev/hdb, /dev/sda,
  192.    etc., do:
  193.  
  194.    # dd if=/dev/DISKNAME of=/mnt/floppy/DISKNAME bs=512 count=1
  195.  
  196. Restoring recovery information from your rescue floppy:
  197.  
  198.    If you've got a disk that became corrupted and you wish to restore it,
  199.    first restore the partition table of the disk. After booting from this
  200.    CD-ROM, put in your rescue floppy and type:
  201.  
  202.    # mkdir -p /mnt/floppy
  203.    # mount -t ext2 /dev/fd0 /mnt/floppy
  204.    # cd /
  205.    # umount /dev/DISKNAME*
  206.    # dd if=/mnt/floppy/DISKNAME of=/dev/DISKNAME
  207.  
  208. Mounting other filesystems
  209.  
  210.    If you want to mount a filesystem which was not automatically mounted
  211.    during boot time, you can do so by creating a "mount point" and
  212.    mounting the filesystem on the "mount point". Here is an example:
  213.  
  214.    # mkdir -p /mnt/mydir
  215.    # mount -t vfat /dev/hda4 /mnt/mydir
  216.  
  217.    Note that if you want to mount a filesystem with a type not listed in
  218.    /proc/filesystems, you will need to load the appropriate module for
  219.    the filesystem first.
  220.  
  221.    # modprobe ufs
  222.  
  223. Using utilites to repair or recover data:
  224.  
  225.    Many disk-related utilities have been included on this CD-ROM,
  226.    including fsck and mkfs utilities, several versions of fdisk, and many
  227.    other powerful utilities. For the ultimate in low-level disk editing,
  228.    try "lde", but do so ONLY if you know how to use the tool. (To see
  229.    what's installed, type "ls /usr/bin"; please locate and read
  230.    documentation for any piece of software with which you are unfamiliar
  231.    before attempting to use it to recover data.) In efforts to bring you
  232.    more tools we have not included all the documentation available.
  233.  
  234. Getting networking to work:
  235.  
  236.    This rescue system is fully capable of Ethernet networking.
  237.  
  238.    If you want to enable networking, you can use the "trivial-net-setup"
  239.    script. Just type
  240.  
  241.    # trivial-net-setup
  242.  
  243.    and follow the directions to specify information about your Ethernet
  244.    network. If you have a PCI network card, you will generally be able to
  245.    specify the appropriate module name when trivial-net-setup prompts
  246.    you. You may also allow trivial-net-setup to autoprobe for a driver
  247.    for your PCI network card.
  248.  
  249.    If you have an ISA network card, you will probably need to load
  250.    manually one of the many ISA network kernel modules which are included
  251.    on the CD-ROM. Go to the /mnt/cdrom/lib/modules/2.2.13/net directory
  252.    and run:
  253.  
  254.    # insmod MODULENAME
  255.  
  256.    If you have a DHCP server on your network, you can configure your
  257.    networking with DHCP; otherwise, you can manually configure your
  258.    network card with tools like ifconfig and route. "trivial-net-setup"
  259.    provides a friendlier interface to this process; you really should try
  260.    it.
  261.  
  262.    Now check your DNS servers in /etc/resolv.conf (we've included
  263.    defaults which will work if you're directly connected to the
  264.    Internet), and your connection should be usable.
  265.  
  266.    If you have networking trouble, you can use the included network
  267.    diagnostic utilities, including several card-level diagnostics, ping,
  268.    traceroute, DNS query utilities, and more.
  269.  
  270. Getting ssh to run:
  271.  
  272.    Due to export restrictions, previously we couldn't put ssh onto the
  273.    system. However, this has changed so we could include these with this
  274.    release. We have installed ssh and related utilities; if you have
  275.    networking up and a connection to the internet we strongly encourage
  276.    you to use ssh and scp.
  277.  
  278.    Note that rsh on older versions of the BBC was a symbolic link to ssh,
  279.    so you needed to get ssh in order to use anything that depends on rsh,
  280.    including (for instance) rsync. This release has rsh and rcp so, if
  281.    you are on a trusted network, you can use these for possibly faster
  282.    transfers.
  283.  
  284. Pcmcia:
  285.  
  286.    If you have a laptop which uses PCMCIA ("PC Cards"), you should be
  287.    aware that this version of the Bootable Business Card now includes the
  288.    PCMCIA Card Services distribution (along with its default kernel
  289.    modules).
  290.  
  291.    Most laptops should have PCMCIA Ethernet and a few other devices
  292.    supported by simply typing
  293.  
  294.    # pcmcia start
  295.  
  296.    If your network card is detected by this procedure, you can
  297.    immediately follow it with
  298.  
  299.    # trivial-net-setup
  300.  
  301.    to configure networking.
  302.  
  303.    If "pcmcia start" doesn't work for you, you may want to read the
  304.    documentation, such as the PCMCIA-HOWTO, to learn more about getting
  305.    PCMCIA working.
  306.  
  307. Plug-n-play(tm):
  308.  
  309.    In order to get any Plug-n-Play(tm) cards running, see the
  310.    Plug-and-Play-HOWTO on the CD-ROM. This CD-ROM includes the
  311.    isapnptools distribution for configuring ISA PnP devices.
  312.  
  313. Changes:
  314.  
  315.    Please see the file "CHANGES" for information on what's new and
  316.    improved in this version.
  317.  
  318. Installing Debian GNU/Linux to a hard drive:
  319.  
  320.    This might work in this release, although it will take some effort
  321.    and expertise.  A network connection is also required.
  322.  
  323.    See "README-DEBIAN" for more information.
  324.  
  325. Getting support:
  326.  
  327.    There is a mailing list set up so that users of this CD-ROM can
  328.    support each other.  This list is also used for discussions between
  329.    developers on the project, and for announcements about its progress.
  330.  
  331.    To subscribe or unsubscribe:
  332.  
  333.         Follow the directions at
  334.  
  335.         http://zork.net/mailman/listinfo/lnx-bbc/
  336.  
  337.    Once you're subscribed, you can send a message to the list by sending
  338.    the e-mail to:
  339.  
  340.         lnx-bbc@zork.net
  341.  
  342.    Enjoy!
  343.  
  344.    -- The LNX-BBC CD-ROM Team
  345.  
  346. Direct contributions for the current version come from:
  347.  
  348.    Technical work & support
  349.    ------------------------
  350.  
  351.    Juraj Bednar
  352.    Zack Brown
  353.    Jim Dennis
  354.    Amy Foldesi
  355.    Ian Harding
  356.    Klaus Knopper (cloop)
  357.    Duncan MacKinnon <duncan@randometry.org>
  358.    Nick Moffitt
  359.    Niall O Broin
  360.    Daniel J. O'Neill
  361.    Seth Schoen <schoen@loyalty.org>
  362.    Heather Stern <star@starshine.org>
  363.    Andrew Scott <ascott@tathata.org>
  364.  
  365.  
  366.    Financial support for duplication
  367.    ---------------------------------
  368.  
  369.    David W. Bryson
  370.    Irish Linux Users Group (ILUG)
  371.    Duncan MacKinnon
  372.    Chuck Moss
  373.    Andrew Scott
  374.    Heather Stern
  375.    Michael E. Weiblen
  376.  
  377.  
  378.    "Facile credo, plures esse Naturas invisibiles quam visibiles in rerum
  379.    universitate.  Sed horum omnium familiam quis nobis enarrabit? et gradus
  380.    et cognationes et discrimina et singulorum munera?"
  381.  
  382.        -- Burnet, in Coleridge
  383.  
  384. Acknowledgements:
  385.  
  386.    Andy Yuen helped us substantially with duplication logistics.  Thanks!
  387.  
  388.    Thanks to the following people for their contributions and support for the
  389.    original project:
  390.  
  391.    Duncan MacKinnon (duncan@randometry.org)
  392.    Seth Schoen
  393.    Tom "inf" Crimi
  394.    Tim Moss
  395.    Andrew "tty" Scott
  396.    Sylvester "Sly" Smith
  397.    David "hacker" Desrosiers
  398.    Mike Perry
  399.    David Benfell
  400.    Marjorie Cango
  401.    Mike Hartley
  402.    Rasmus Lerdorf
  403.    Melissa Almgren
  404.    Ian Macdonald
  405.    Shawn Mckenzie
  406.    Andrew Gavurnik
  407.    Sam McDonald
  408.    Mike Higashi
  409.    Jim Dennis
  410.    Patrice Regan
  411.    Art Tyde
  412.    Dave Sifry
  413.    Dave Mandala
  414.    Rob "lilo" Levin
  415.    Paul "Rusty" Russell
  416.    David Welton
  417.    Brian Abshier
  418.    Rick Moen
  419.    Michael Angelo (yes, that's his real name)
  420.    Minh "Ming" Trinh
  421.    David Kaiser
  422.    Nick Moffitt
  423.    Christopher Beard
  424.    Phil Schwan
  425.    David Kennedy
  426.    Matthew Wilcox
  427.    Marc Merlin
  428.    Nathan Myers
  429.    The Linuxcare Labs Team
  430.    The Linuxcare Tech Support Team
  431.    The Puffin Group
  432.    Other Linuxcare staff
  433.  
  434.    Linuxcare, Inc., supported development and developers for five prior
  435.    releases of the Linuxcare Bootable Business Card, from which this
  436.    project is derived, and produced and distributed at its own expense
  437.    tens of thousands of free copies for Linux enthusiasts all over the
  438.    world.
  439.  
  440.    Special thanks go to the folks who made Tom's Root/Boot, Hal91, and
  441.    ODL, to the Debian Project, Red Hat, Inc., and to all the people who
  442.    have contributed to the programs included on this CD-ROM -- and to the
  443.    worldwide free software community.
  444.  
  445.    For their comments and assistance, we wish to thank Adam Di Carlo,
  446.    Joey Hess, and Sean "Shaleh" Perry of the Debian Project, as well as
  447.    the members of Linuxcare's lnx-bbc mailing list.
  448.  
  449.    Tux, the Linux penguin, was created by Larry Ewing <lewing@isc.tamu.edu>
  450.    using the GIMP (GNU Image Manipulation Program).
  451.  
  452.    Linux is a registered trademark of Linus Torvalds.
  453.