dnl README-Users.m4 - Will become top-level README in disks-<arch>.
dnl <!-- original version 1.39 -->
dnl
dnl Use [] for quotes so that in the emacsen, `forward-sexp' and
dnl `backward-sexp' along with paren highlighting will help find nesting
dnl errors.
dnl
changequote([,])dnl
dnl
dnl Most platforms have sub-architectures, define them here.
dnl
dnl FIXME: This should be defined in the top-level Makefile
dnl        and passed in by way of `release.sh', which is where
dnl        this file gets run through `m4'.
dnl
ifelse(ARCHITECTURE, sparc,   [define(SUBARCHES, [sun4cdm, sun4u, sun4dm-pci])],
       ARCHITECTURE, m68k,    [define(SUBARCHES, [amiga, atari, mac, mvme16x, bvme6000])],
       ARCHITECTURE, powerpc, [define(SUBARCHES, [apus, chrp, powermac, new-powermac, prep])],
       ARCHITECTURE, alpha,   [define(SUBARCHES, [jensen, nautilus])],
       ARCHITECTURE, mips,    [define(SUBARCHES, [r4k-ip22])],
       ARCHITECTURE, hppa,    [define(SUBARCHES, [32, 64])])[]dnl
dnl
dnl A few platforms have flavors, define them here.
dnl
dnl FIXME: Perhaps this should be defined in the top-level Makefile (?)
dnl
dnl If you need to add to this list, please see to it that it will be
dnl formatted nicely where it is expanded below by putting a line break
dnl and a 6 space indent in the right place inside the definition of
dnl FLAVORS.
dnl
dnl For that reason, it might not be the right thing to define this from
dnl the Makefile.
dnl
ifelse(ARCHITECTURE, i386, [define(FLAVORS, [`compact', 'idepci',
      i `ide'])])[]dnl
dnl
dnl Some, but not all, platforms have several sizes of diskette images.
dnl
ifelse(ARCHITECTURE, i386,    [define(SIZES,t)],
       ARCHITECTURE, sparc,   [undefine(SIZES)],
       ARCHITECTURE, m68k,    [define(SIZES,t)],
       ARCHITECTURE, powerpc, [undefine(SIZES)],
       ARCHITECTURE, alpha,   [undefine(SIZES)])[]dnl
dnl
dnl
dnl See the comment in "utilities/dbootstrap/main.c:setup_image_names()"
dnl for information about the directory layout expected by `dbootstrap'.
dnl
dnl          <debian>/${subarch}${images_size}${flavor}
dnl

		    El Sistema d'Installaci de Debian
                    ===================================

                             Orientaci

  Aquest fitxer README s per a posar-lo al corrent del contingut del
  sistema d'installaci de Debian i a on obtindre ms informaci.

  Si desitgeu retornar a aquest directori haureu d'anar a

    <debian>/dists/RELNAME/main/disks-ARQUITECTURA/current/

  a on la paraula "<debian>" pot indicar una rplica del servidor web
  de Debian, una rea FTP o un CD-ROM oficial de Debian.  Tots els
  fitxers requerits per la installaci poden trobar-se sota aquest
  directori.

  La documentaci completa sobre el sistema d'installaci Debian pot
  trobar-se sota el subdirectori "doc/".  La documentaci est
  disponible en diversos formats i idiomes.  Tamb podria ser que
  volgussiu consultar <URL:http://www.debian.org/releases/NOM_REAL/>
  per a cercar errades en la documentaci, alertes de seguretat o
  d'altra informaci actualitzada.

  Pels ms impacients, les instruccions d'installaci rpida seran
  descrites aqu.  D'altra manera, us *encoratgem* a llegir-vos la
  documentaci completa que es troba en el subdirectori "doc/",
  especialment en el cas de trobar-vos amb dificultats.



                   Instruccions Installaci Rpida
                   ================================

  Encara que el Sistema d'Installaci tamb s'anomena "boot-floppies",
  aquest nom s una distorsi histrica.  Es possible, i fins i tot
  desitjable, installar Debian sense usar cap disquet.  Per exemple,
  poder installar Debian des d'un CD-ROM oficial de Debian que sigui
  arrencable, des de la xarxa o des d'algun altre sistema operatiu.


  Installar des del CD-ROM
  -------------------------

  El mtode d'installaci recomenat s des dels CD-ROM oficials de
  Debian.  Aquests poden aconseguir-se als llocs a on venen
  distribucions de GNU/Linux o en lnia en
  <URL:http://www.debian.org/distrib/vendors>.

  Els qui tinguin una cremadora de CD i una certa disposici
  aventurera podran escollir crear-los des de les imatges de CD-ROM
  en <URL:http://cdimage.debian.org/>.

  Installar des de CD-ROM normalment s molt fcil i sols precisa
  que escrigueu un comandament desprs d'arrencar i d'inserir el CD.
  Si el vostre ordinador s SRM (p.e. no t un sistema de mens al
  comenar) simplement escriviu "boot xxx -fl 0" a on xxx ser la
  vostra unitat lectora de CD-ROM en notaci SRM.  Executeu "show dev"
  per a cercar aquest nom en la vostra mquina.  Per a una completa
  descripci, podreu cercar-la en el manual d'installaci.

  Si la vostra mquina s ARC o AlphaBIOS, mireu a sota en la secci
  MILO pels detalls.


  Installar des de disquets
  --------------------------

  Si no teniu un CD-ROM o si el vostre ordinador no pot arrencar des
  d'un CD-ROM llavors haureu d'usar les imatges de disquets localitzades
  sota aquest directori.  Les imatges de disquet s'anomenen "*.bin".
  Per norma general necessitareu les imatges "rescue.bin" (de rescat) i
  "root.bin" (arrel), i de vegades tamb les imatges "driver-*.bin" (de
  controladors".

  Noteu que teniu disponibles diversos jocs d'aquestes imatges, depenent
  de la arquitectura que tingueu.  Haureu d'escollir un joc entre tots
  els disponibles.  Per a ms detalls mireu a sota la descripci dels
  diversos subdirectoris que contenen les imatges de disquet.

  Els fitxers "driver-*.bin" contenen controladors per a maquinari
  suplementari que no est en el nucli de la imatge "rescue.bin".  No es
  requerir sempre la creaci dels disquets per a carregar aquests
  controladors, p.e. quan la installaci pugui aconseguir els
  controladors des d'un medi diferent als disquets.  Aix s bsicament
  una qesti del maquinari suportat prpiament pel nucli.

  Si no creeu els disquets "driver-*.bin", desprs durant la
  installaci necessitareu una cpia de "rescue.bin" i "drivers.tgz"
  disponible des d'un medi diferent als disquets.  Quan s'us pregunti
  pel sistema operatiu i els mduls, obviament no podreu respondre-li al
  sistema que usareu disquets donat que no heu creat els disquets dels
  controladors.  Digueu-li a l'installador que aconsegueixi aquestes
  des del CD-ROM, disc dur local o qualsevol lloc des a on els fitxers
  hagin estat descarregats.

  *No podeu* crear els disquets a partir dels fitxers *.bin simplement
  copiant-los en els disquets.  El mtode per a crear els disquets des
  dels diversos fitxers *.bin varia segons el sistema operatiu al que
  tingueu accs.  Seguidament trobareu les descripcions de com crear
  disquets des de fitxers *.bin en Unix i des de DOS.

  Es recomana usar sempre disquets nous, donat que els usats podrien
  contindre errors i causar falles durant l'arrencada.

  - Creant disquets des d'imatges de disquet en Unix

    Useu el comandament de GNU "dd" per a crear un disquet des d'un
    fitxer .bin:

        dd of=/dev/fd0 if=<fitxer> bs=1024

    El vostre dispositiu per a accedir al disquet podria ser un altre
    diferent a "/dev/fd0".

    Si sou de naturalesa desconfiada, us podreu assegurar de que la
    imatge ser escrita amb xit amb:

        cmp /dev/fd0 <fitxer>

  - Creant disquets des d'imatges de disquet en DOS

    Canvieu al directori que contingui els fitxers *.bin que desitgeu.
    Per a crear la imatge useu la utilitat de DOS "rawrite2.exe" que
    est en el subdirectori "dosutils", per exemple:

		..\dosutils\rawrite2 -f rescue.bin -d a

     a on "a" es referir a la primera disquetera en el vostre
     ordinador, i "rescue.bin" representar al fitxer *.bin des del que
     desitgeu crear el disquet.
ifelse(ARCHITECTURE, i386, [dnl


  Installar des de l'interior de DOS
  -----------------------------------

  Si no teniu un CD-ROM oficial i esteu executant DOS o Windows, aquesta
  s una altra alternativa per a crear els disquets.  Podeu executar el
  fitxer DOS de lots "install.bat" des d'un dels subdirectoris superiors.

  Mireu ms avall per a una descripci detallada dels diversos
  subdirectoris que contenen el "install.bat".
])
ifelse(ARCHITECTURE, hppa, [dnl


  Installar des de la xarxa
  ---------------------------

  Una altra opci per a HPPA s el installar des de la xarxa.  Per a
  fer-ho necessitareu arrencar des de la imatge "lifimage".  Moltes
  mquines HPPA usen bootp per a arrencar sobre la xarxa, tot i que
  algunes antigues (p.e. 715/75) usen rbootd.
])
ifelse(ARCHITECTURE, mips, [dnl


  Installar des de la xarxa
  --------------------------

  Una altra opci per a MIPS s el installar des de la xarxa.  Per a
  fer-ho necessitareu arrencar des de la imatge "linux.bin".  Moltes
  mquines MIPS usen bootp per a arrencar sobre la xarxa.
])



                  Croquis dels fitxers d'installaci
                  ===================================

  Seguidament us descrivim la organitzaci general dels fitxers en
  aquest directori.  Si copieu un subconjunt d'aquests fitxers al disc
  local, haureu de conservar l'estructura interna de directoris, donat
  que el sistema d'instalaci cercar als fitxers en aquestes
  localitzacions.

  doc/

      El Manual d'Installaci Debian GNU/Linux, la Guia de "dselect"
      per a novells i les Notes de la versi, els podreu trobar aqu en
      diversos formats llegibles i imprimibles pel ordinador.  Si us
      plau, llegiu-vos el manual (Read The Fine Manual - RTFM) abans de
      comenar!
dnl
ifdef([SUBARCHES], [dnl

  <subarquitectura>/

      Fitxers d'installaci subdividits segons l'ARQUITECTURA;
      necessitareu cercar per aqu els vostres discs d'arrencada boot,
      root i drivers.  Aquesta arquitectura ser una de les segents
      <subarquitectures>:

           SUBARCHES
dnl
ifelse(ARCHITECTURE, sparc, [dnl

     sun4cdm .... Aquesta s usada per molts sistemes no-Ultra.  Aix
                  inclou les SPARCStation 1, 2, ELC, IPC, IPX, 5, 10, 20
                  aix com les SPARC Classics.

     sun4dm-pci . Idntic al nucli d'adalt per amb el suport per a PCI
                  usat en els sistemes que tenen un bus PCI i / o un
		  ratol i teclat ps2.

     sun4u ...... Aquesta inclou totes les classes de sistemes UltraSPARC,
                  inclosos els sistemes IDE com el UltraSPARC 5.  Per a
                  sun4cdm sols varien els disquets rescue i drivers.  La
                  imatge base root s la mateixa.

],dnl
ARCHITECTURE, mips, [dnl

     r4k-ip22.... Aquesta s'usa pels basats en R4X00 de SGI, com els
                  Indy i Indigo2.

     Si us plau noteu que hi han d'altres subarquitectures big endian
     MIPS que actualment no estan suportades.  Pel suport de little
     endian MIPS mireu en l'arquitectura mipsel.

],dnl
ARCHITECTURE, alpha, [dnl

      En els Alpha en general, haureu d'usar les imatges genriques de
      rescue i drivers, que es troben en un directori superior al de
      images-1.44.  Si arranqueu des d'un CD, aquestes seran usades per
      defecte.

      Quan arrenqueu des de disquet en la consola SRM, us recomanem usar
      SRM per a noves installacions (mireu el manual d'installaci),
      sempre haureu d'usar aquest mtode (excepte en la subarquitectura
      "jensen").  Durant l'arrencada amb el disquet de rescat des de la
      consola SRM, escriviu "boot dva0 -fl 0" en l'indicatiu de la
      consola.

      Si esteu arrencant des d'un disquet usant MILO, tamb necessitareu
      un disquet MILO que contingui les imatges de MILO i la de
      LINLOAD.EXE, tal i com es detalla ms endavant.

      La plataforma Nautilus (placa base UP1000) usa APB.  En aquests
      sistemes, els Alpha ms poderosos, inseriu el disc de rescat
      Nautilus i entreu a "apb.exe" com a fitxer d'arrencada en el men
      del AlphaBIOS (el sistema BIOS del Alpha) "OS Selection Setup"
      (establir la selecci del SO) o tamb podeu executar "apb.exe" des
      del men "Utility/Run Maintenance Program" (Utilitats/Executar el
      Programa de Manteniment).  Desprs, en l'indicatiu de APB, escriviu
      "boot debian_install".

  MILO/

      Cont les imatges de disquet i binaris del carregador d'arrencada
      MILO per a certes plataformes.  Aquests sn usats per a arrencar
      en sistemes ARC i AlphaBIOS.

      Per a arrencar en un d'aquests des de CD, cerqueu la vostra
      arquitectura des de la taula que est en la documentaci, llavors
      entreu a "\milo\linload.exe" com el carregador d'arrencada i
      "\milo\<subarquitectura>' (a on <subarquitectura> ser el nom de
      la subarquitectura adequada) com a ruta del SO en el men "OS
      Selection Setup".

      Per a arrencar en un d'aquests des de disquet, creeu un disquet
      tal i com s'ha descrit anteriorment a partir del fitxer
      milo_<subarch>.bin .  Engegueu el vostre Alpha, inseriu aquest
      disc, llavors entreu en el men "OS Selection Setup" de ARC o
      AlphaBIOS.  Establiu el dispositiu d'arrencada de la disquetera,
      el SO Loader (SO a carregar) a "\linload.exe" i la OS Path (Ruta
      del SO) a "milo".  Llabors amb l'indicatiu del MILO, inseriu el
      disc de rescat i entreu el comandament "boot fd0:".  Noteu que en
      els Ruffian hi han coses significativament diferents, mireu el
      manual d'installaci per a ms detalls.

      Els discs de MILO tamb sn arrencables des de la consola SRM,
      encara que per a la installaci us proposem que el disquet de
      rescat sigui usat directament si teniu una consola SRM.

  APB/

      Cont el carregador d'arrencada APB i els fitxers associats per a
      la placa base UP1000.  Aquests sn usats per a arrencar des del CD
      en la UP1000.  Per a arrencar en aquesta plataforma, executeu
      "\apb\apb.exe" des del men "Utility/Run Maintenance Program"
      (Executar la utilitat del programa de gesti) i escriviu "boot
      debian_install" en l'indicatiu de APB.
]dnl,
dnl ARCHITECTURE, XXX, [
dnl This probably ought to be filled in more by the maintainers who know
dnl what to say here for their architecture's subarch's.
dnl]
)[]dnl ifelse(ARCHITECTURE, ...)
])[]dnl ifdef([SUBARCHES], ...)
dnl
ifdef([FLAVORS], [dnl

  ifdef([SUBARCHES],[<subarch>/])<flavor>/

      Aquests sn els diversos "sabors" dels discs d'installaci
      disponibles.  En molts casos els discs contenen un nucli Linux
      compilat amb certes opcions per a fer que aquest funcioni en la
      ms mplia varietat de maquinari possible.  Mireu ms avall per a
      informaci de que s el que necessitareu per a usar un sabor.

      En aquests directoris tamb hi han fitxers per a un sabor en
      particular que no sn imatges de disc, per que poden ser d'ajuda
      per a installacions en xarxa o installacions des d'un altre
      sistema operatiu.

      Durant una installaci en xarxa, NFS, o CD-ROM, el programari
      d'installaci sap com cercar aquests fitxers, una vegada que li
      hagueu indicat el directori <debian>.  Si planifiqueu copiar
      aquests fitxers en algun lloc del vostre disc dur abans d'usar
      l'opci de l'installador "from a mounted partition" (des d'una
      partici muntada), necessitareu duplicar l'estructura de
      directoris de l'arxiu de <debian>, per assegureu-vos de que totes
      les imatges corresponen al mateix <sabor> o probablement aquestes
      no funcionaran correctament.

      Els sabors disponibles per a aquesta arquitectura sn SABORS
      (FLAVORS).
dnl
ifelse(ARCHITECTURE, i386, [dnl

      compact .... Un nucli Linux sense alguns dels controladors pels
                   dispositius no crtics i alguns dels controladors
                   pels dispositius PCI ms comuns compilats a dins
                   del nucli.  Mireu images-1.44/compact/README.txt

      idepci ....  Similar al compact, per amb ms controladors de
                   dispositius PCI compilats a dins del nucli i els
                   SCSI han estat eliminats.  Mireu
                   images-1.44/idepci/README.txt

      ide    ..... Nucli especial pels qui requereixin del peda per
                   a UDMA66 en el subsistema IDE.  Aquest pot ser
                   necessari si teniu una controladora Promise Ultra66
                   IDE, entre d'altres.  Mireu
		   images-1.44/ide/README.txt
]dnl,
dnl ARCHITECTURE, XXX, [dnl
dnl   Other arch with flavor info goes here.
dnl]
)dnl
])[]dnl
dnl
ifdef([SIZES], [dnl

  ifdef([SUBARCHES],[<subarch>/])images-<size>/ifdef([FLAVORS],[<flavor>/])

      Imatges de disc de la grandria de <size>.  Escolliu la grandria
      que quepiga en el medi des del que intenteu carregar la
      installaci i seguiu les instruccions posteriorment escrites
      sobre com "escriure els fitxers de les imatges en els disquets".
])[]dnl


  ** Fitxers especfics d'inters

  Usant les segents descripcions, necessitareu seleccionar el directori
  que contingui el joc de fitxers que seran ms apropiats per a la
  installaci que fareu.  Necessitareu totes les segents imatges
  ".bin", a menys de que s'us indiqui el contrari.

  .../rescue.bin

      La imatge de disc de rescat (rescue), cont el nucli i el carregador
      d'arrencada.

  .../root.bin

      La imatge arrel (root), cont el sistema de fitxers arrel.  No
      requerida a menys de que estigueu installant des de disquets.

  .../driver-#.bin

      Imatges de disc dels controladors per a dispositius, contenen els
      mduls del nucli que podreu carregar en el nucli si aquest
      controlador no ha estat construit a dins del mateix nucli.  Per
      exemple, podeu usar aix per a installar un controlador per a un
      adaptador de xarxa; quan tingueu installat aquest controlador,
      podreu installar la resta del sistema sobre la xarxa.  D'altres
      mduls inclosos el de PPP, suport de port parallel, etc.  Aquests
      no us seran requerits a menys de que estigueu installant des de
      disquets.

  .../drivers.tgz

      Un arxiu tar comprimit que cont els mateixos mduls que en les
      imatges de disc anteriors.  Aquest s usat quan s'installa el
      nucli i controladors des del disc dur local o CD.  Usar el fitxer
      del del subdirectori base apropiat de la
      ifdef([SUBARCHES],subarquitectura)[]ifdef([FLAVORS],sabor) que
      esteu usant.

dnl
ifelse(ARCHITECTURE, sparc, [dnl

  .../tftpboot.img

      Imatges per a arrencar el TFTP especifiques de la subarquitectura.
      Aquestes imatges contenen el nucli i el root.bin per a poder
      arrencar completament des d'un servidor TFTP usant el comandament
      "boot net" de la PROM.  Mireu la documentaci pels detalls.

  root.tar.gz

      Un tarball de l'arrel, muntable per NFS.  Aquest s exactament el
      mateix que el root.bin, per en un [format] tar, per a poder
      extreuren el contingut en un servidor de xarxa i installar
      sistemes mitjanant una arrel NFS.  Mireu la documentaci pels
      detalls.

],dnl
ARCHITECTURE, hppa, [dnl

   lifimage

      Una imatge arrencable en la xarxa que cont el root.bin, a ms de
      nuclis de 32 i 64 bits.  Aquest s un fitxer que necessitareu per
      a arrencar i poder fer una installaci basada en la xarxa.

],dnl
ARCHITECTURE, mips, [dnl

  root.tar.gz

      Un tarball de l'arrel, muntable per NFS.  Aquest s exactament el
      mateix que el root.bin, per en un [format] tar, per a poder
      extreuren el contingut en un servidor de xarxa i installar
      sistemes mitjanant una arrel NFS.  Mireu la documentaci pels
      detalls.

],dnl
ARCHITECTURE, alpha, [dnl

  .../linload.exe

      Aquest executable per a la consola ARC s necessari per a carregar
      MILO

  .../apb.exe

      El carregador per a processadors Alpha, un executable per a la
      consola ARC usat per a carregar Linux en les plaques base UP1000
      de Alpha Processor, Inc.

  .../up1000.pal

      PALCode (Privileged Architecture Library code -codi amb
      preferncia dins l'arquitectura-) per a les plaques base UP1000.

  tftpboot.img

      Imatge arrencable TFTP.  Aquesta imatge cont el nucli i el
      root.bin per a poder arrencar completament des d'un servidor TFTP
      usant la consola SRM.  Mireu el manual d'installaci per a
      informaci detallada.

  root.tar.gz

      Un tarball de l'arrel, muntable per NFS.  Aquest s exactament el
      mateix que el root.bin, per en un [format] tar, per a poder
      extreuren el contingut en un servidor de xarxa i installar
      sistemes mitjanant una arrel NFS.  Mireu la documentaci pels
      detalls.

])[]dnl
dnl
ifdef([ADDONS_TGZ], [dnl

  ADDONS_TGZ

      Un arxiu tar comprimit que cont coses addicionals, ficades alegrement
      per la gent que ha fet aquest CD-ROM.  Aix podria se qualsevol classe
      de deixalla que alg pot considerar que fan els seus CD sn millors que
      els de la versi oficial de Debian.

])[]dnl
dnl
ifelse(ARCHITECTURE, i386, [dnl

  .../install.bat

      Fitxer de lots de DOS per a arrencar dins del sistema
      d'installaci des de DOS.  Hi ha disponible una versi diferent
      d'aquest fitxer per a cada sabor.

  .../linux.bin

      Una imatge del nucli Linux, usat pel script citat anteriorment.

])[]dnl
dnl
  md5sum.txt

      Un fitxer que cont les sumes MD5 dels fitxers d'installaci.
      Aquest pot usar-se per a verificar que els fitxers descarregats no
      s'han corromput.

dnl
dnl Local Variables:
dnl compile-command: "m4 --define=RELNAME=woody --define=ARCHITECTURE=i386 README-Users.m4"
dnl fill-prefix: "  "
dnl End:
dnl LocalWords:  sparc SUBARCHES cdm amiga atari mac mvme bvme powerpc chrp sh
dnl LocalWords:  powermac alcor avanti idepci udma undefine dbootstrap debian doc
dnl LocalWords:  subarch dselect RTFM ifdef SPARCStation ELC IPC IPX UltraSPARC
dnl LocalWords:  IDE SRM jensen subarchitecture dva fl MILO LINLOAD APB apb milo
dnl LocalWords:  AlphaBIOS linload fd XXX subarch's installer's PCI PPP TGZ TFTP
dnl LocalWords:  PROM Bootloader PALCode tftpboot img ADDONS CDs basecont txt
dnl LocalWords:  linux dd bs cmp tgz dnl emacsen sexp paren changequote FIXME
dnl LocalWords:  ifelse dm pci ps EXE exe docs tarball rawrite