.\" Copyright (c) 1997 David Hinds .\" pcinitrd.8 1.2 1997/04/24 15:47:25 .\" .TH PCINITRD 8 "$Date" "Stanford University" .SH NAME pcinitrd \- create a PCMCIA initrd ram disk image .SH SYNOPSIS .B pcinitrd .RB [ -v ] .RB [ -a ] .RB [ --all ] .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 DESCRIPTION The .B pcinitrd script creates an initrd ram disk image for booting with the root filesystem on a PCMCIA device. If the target is a block special device (i.e., .IR /dev/fd0 ), then the initrd image is created on that device. If the target does not already exist or if it is an ordinary file, then .B pcinitrd will create the image file using the ``loopback'' device. .PP Modules are specified with paths relative to .IR /lib/modules/[kernel-release] . The core PCMCIA modules .RI ( pcmcia/pcmcia_core and .IR pcmcia/ds ) will automatically be installed in the target image. All other device-specific modules need to be listed on the command line, along with the appropriate socket driver .RI ( pcmcia/i82365.o or .IR pcmcia/tcic.o ). Alternatively, if .B -a is specified, then all available PCMCIA socket drivers and block device drivers will be included in the image. .PP The startup script in the resulting image, .IR linuxrc , may need to be customized for a particular system. It contains the same variable definitions as the normal PCMCIA startup scripts (i.e., .BR PCIC= , .BR PCIC_OPTS= , and .B CORE_OPTS= variables). The .I /etc/config.opts file may also need to be edited. Any changes to .I linuxrc or .I config.opts will be preserved if .B pcinitrd is executed in ``update'' mode. Another feature of the generated .I linuxrc is that if the .B SHELL variable is set to a non-blank string at the boot prompt, then after .I linuxrc executes, it will fire up a shell on the console. This can be helpful for debugging initrd problems. .SH OPTIONS .TP .B \-v Verbose mode. Identify files as they are copied. .TP .B \-a, \-\-all Install all socket drivers and block-style PCMCIA device drivers, including memory card, SCSI card, and fixed-disk drivers. This is mainly intended for use by package maintainers. .TP .BI "\-r " kernel-release ", " "\-\-release=" kernel-release Specifies the kernel release number (i.e., 2.0.28) to use when looking for modules in /lib/modules. The default is the release of the running kernel. .TP .BI "\-s " image-size ", " "\-\-size=" image-size Specifies the filesystem size to create on the target file or device, in 1k blocks. The default is 1440. .TP .B \-u, \-\-update Update mode: updates .B cardmgr and all the kernel modules in an existing initrd image, but does not modify other files. .SH AUTHOR David Hinds \- dhinds@hyper.stanford.edu .SH "SEE ALSO" pcmcia(5), cardmgr(8), lilo(8).