manual/pcmcia-cs/original/man8/ftl_format.8

   1 .\" Copyright (C) 1998 David A. Hinds -- dahinds@users.sourceforge.net
   2 .\" ftl_format.1 1.10 2000/06/12 21:24:48
   3 .\"
   4 .TH FTL_FORMAT 1 "2000/06/12 21:24:48" "pcmcia-cs"
   5 .SH NAME
   6 ftl_format \- Flash Translation Layer formatting utility
   7 .SH SYNOPSIS
   8 .B ftl_format
   9 .RB [ -q ]
  10 .RB [ -i ]
  11 .RB [ "\-s "\c
  12 .IR spare ]
  13 .RB [ "\-r "\c
  14 .IR reserve ]
  15 .RB [ "\-b "\c
  16 .IR bootsize ]
  17 .I device
  18 .SH DESCRIPTION
  19 .B Ftl_format
  20 creates a Flash Translation Layer partition on a flash memory device.
  21 It needs to access the flash partition's raw character-mode device
  22 (such as
  23 .IR /dev/mem0c0c ).
  24 .PP
  25 This is actually a low-level format operation, required before
  26 accessing a memory device via the FTL block device driver.  Once a
  27 partition is prepared with
  28 .BR ftl_format ,
  29 a filesystem should be created in a separate step.  Filesystem
  30 commands should access the device via the FTL device file (such as
  31 .IR /dev/ftl0 ).
  32 .PP
  33 Optionally,
  34 .B ftl_format
  35 can reserve a region at the beginning of the flash card address space
  36 for a boot image (or any other purpose).  The boot area is not part of
  37 the FTL partition, and can only be accessed via the raw memory device.
  38 .PP
  39 On Intel Series 100 flash cards, the first flash block is used to
  40 store the card's configuration information structures.  If no boot
  41 area is specified on the command line,
  42 .B ftl_format
  43 will automatically create one to span the first block.
  44 .SH OPTIONS
  45 .TP
  46 .B \-q
  47 Quiet mode: don't print formatting statistics.
  48 .TP
  49 .B \-i
  50 Interactive: confirm before beginning the format.
  51 .TP
  52 .BI "\-s " spare
  53 Reserve the specified number of erase blocks as spares.  The default
  54 is 1.  A read-write partition requires at least one spare block.
  55 .TP
  56 .BI "\-r " reserve
  57 Reserve the specified percentage of the total space on the device to
  58 improve write efficiency.  The default is 5%.  Reserving less space
  59 increases the frequency of flash erase operations to reclaim free
  60 blocks.
  61 .TP
  62 .BI "\-b " bootsize
  63 Requests that a portion of the flash card be reserved for a boot
  64 image.  The size will be rounded up to an integral number of erase
  65 blocks.
  66 .SH AUTHOR
  67 David Hinds \- dahinds@users.sourceforge.net
  68 .SH "SEE ALSO"
  69 ftl_cs(4), ftl_check(8).