.\" Copyright (C) 1998 David A. Hinds -- dahinds@users.sourceforge.net.\" pcinitrd.8 1.13 2000/07/25 18:31:33.\".TH PCINITRD 8 "$Date" "pcmcia-cs".SH NAMEpcinitrd \- create a PCMCIA initrd ram disk image.SH SYNOPSIS.B pcinitrd.RB [ -v ].RB [ -a ].RB [ --all ].RB [ "\-d\ "\c.I alternate-root\c].RB [ \-\-dir=\c.I alternate-root\c].RB [ "\-r\ "\c.I kernel-release\c].RB [ \-\-release=\c.I kernel-release\c].RB [ "\-s\ "\c.I image-size\c].RB [ \-\-size=\c.I image-size\c].RB [ -u ].RB [ --update ].I initrd-image.RI [ "modules\ ..." ].SH DESCRIPTIONThe.B pcinitrdscript creates an initrd ram disk image for booting with the rootfilesystem on a PCMCIA device.  If the target is a block specialdevice (i.e.,.IR /dev/fd0 ),then the initrd image is created on that device.  If the target doesnot already exist or if it is an ordinary file, then.B pcinitrdwill create the image file using the ``loopback'' device..PPModules are specified with paths relative to.IR /lib/modules/[kernel-release] .The core PCMCIA modules.RI ( pcmcia/pcmcia_coreand.IR  pcmcia/ds )will automatically be installed in the target image.  All otherdevice-specific modules need to be listed on the command line,along with the appropriate socket driver.RI ( pcmcia/i82365.oor.IR pcmcia/tcic.o ).Alternatively, if.B -ais specified, then all available PCMCIA socket drivers and blockdevice drivers will be included in the image.  Additional files to becopied to the initrd image may also be listed on the command line.Executable programs will be installed in.IR /bin ,shared libraries will be installed in.IR /lib ,device files will be installed in.IR /dev ,and any other files will be placed in.IR /etc ..PPThe startup script in the resulting image,.IR linuxrc ,may need to be customized for a particular system.  It contains thesame variable definitions as the normal PCMCIA startup scripts (i.e.,.BR PCIC= ,.BR PCIC_OPTS= ,and.B CORE_OPTS=variables).  The.I /etc/config.optsfile may also need to be edited.  Any changes to.I linuxrcor.I config.optswill be preserved if.B pcinitrdis executed in ``update'' mode..PPAnother feature of the generated.I linuxrcis that if the.B DEBUGvariable is set to a non-blank string at the boot prompt, then cardmgrwill echo all its status messages to the console, and after.I linuxrcexecutes, it will fire up a shell on the console.  This can be helpfulfor debugging initrd problems.  However, few commands are available inthe normal initrd environment..SH OPTIONS.TP.B \-vVerbose mode.  Identify files as they are copied..TP\fB\-a\fR, \fB\-\-all\fRInstall all socket drivers and block-style PCMCIA device drivers,including memory card, SCSI card, and fixed-disk drivers.  This ismainly intended for use by package maintainers..TP\fB\-d\fI alternate-root\fR, \fB\-\-dir=\fIalternate-root\fRSpecifies an alternate directory tree to search for all the files usedto put together the initrd image.  This may be helpful for running .B pcinitrdafter booting from an installation or rescue diskette..TP\fB\-r\fI kernel-release\fR, \fB\-\-release=\fIkernel-release\fRSpecifies the kernel release number (i.e., 2.0.28) to use when lookingfor modules in /lib/modules.  The default is the release of therunning kernel..TP\fB\-s\fI image-size\fR, \fB\-\-size=\fIimage-size\fRSpecifies the filesystem size to create on the target file or device,in 1k blocks.  The default is 2400..TP\fB\-u\fR, \fB\-\-update\fRUpdate mode: updates.B cardmgrand all the kernel modules in an existing initrd image, but does notmodify other files..SH AUTHORDavid Hinds \- dahinds@users.sourceforge.net.SH "SEE ALSO"pcmcia(5), cardmgr(8), lilo(8).