.\" Copyright (C) 1998 David A. Hinds -- dahinds@users.sourceforge.net
.\" ftl_cs.4 1.11 2000/06/12 21:24:47
.\"
.TH FTL_CS 4 "2000/06/12 21:24:47" "pcmcia-cs"
.SH NAME
ftl_cs \- Flash Translation Layer driver for PCMCIA memory cards
.SH SYNOPSIS
.B insmod ftl_cs.o
.RB [ pc_debug=\c
.IR n ]
.RB [ major_dev=\c
.IR n ]
.SH DESCRIPTION
Flash memory devices typically need to be erased before they are
written, and most flash devices can only be erased on large block
boundaries like 64K or 128K.  The Flash Translation Layer driver, 
.BR ftl_cs ,
implements a sort of virtual sector-addressable block device that
hides the details of erase operations.  Using the FTL driver, a flash
memory card can be treated as an ordinary block device.
.PP
The
.B ftl_cs
driver allocates a major device number when it is loaded.  Minor
device numbers have a bitwise layout of 'dddrrppp'.  'ddd' is the
device number, with one card counting as one device.  'rr' is the
common-memory region number, generally 0.  And 'ppp' selects a logical
partition within the FTL region.
.PP
The default configuration script for FTL devices will create a block
device with the name of the form '/dev/ftl{d}c{r}', where '{d}' is the
device number and '{r}' is the region number, that spans the
entire FTL region.  It also creates devices '/dev/ftl{d}c{r}p[1-4]'
pointing to partitions 1 through 4 within this FTL region. 
.PP
An FTL region must be formatted before use.  The formatting
utility,
.BR ftl_format ,
needs to write to the corresponding raw memory device rather than the
FTL device interface.
.SH PARAMETERS
.TP
.BI pc_debug= n
Selects the PCMCIA debugging level.  This parameter is only available
if the module is compiled with debugging enabled.  A non-zero value
enables debugging.
.TP
.BI major_dev= n
Selects the major device number to allocate for FTL devices.  The
default is to pick any available major number.
.SH AUTHOR
David Hinds \- dahinds@users.sourceforge.net
.SH "SEE ALSO"
ftl_format(8), cardmgr(8), memory_cs(4), pcmcia(5).