sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget//translations/zh_CN/admin-guide/blockdev/floppymodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/zh_TW/admin-guide/blockdev/floppymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/it_IT/admin-guide/blockdev/floppymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/ja_JP/admin-guide/blockdev/floppymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/ko_KR/admin-guide/blockdev/floppymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/pt_BR/admin-guide/blockdev/floppymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget//translations/sp_SP/admin-guide/blockdev/floppymodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h Floppy Driverh]h Floppy Driver}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhI/var/lib/git/docbuild/linux/Documentation/admin-guide/blockdev/floppy.rsthKubh)}(hhh](h)}(h FAQ list:h]h FAQ list:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hlA FAQ list may be found in the fdutils package (see below), and also at .h](hIA FAQ list may be found in the fdutils package (see below), and also at <}(hhhhhNhNubh reference)}(h!https://fdutils.linux.lu/faq.htmlh]h!https://fdutils.linux.lu/faq.html}(hhhhhNhNubah}(h]h ]h"]h$]h&]refurihuh1hhhubh>.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]faq-listah ]h"] faq list:ah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h6LILO configuration options (Thinkpad users, read this)h]h6LILO configuration options (Thinkpad users, read this)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhK ubh)}(hThe floppy driver is configured using the 'floppy=' option in lilo. This option can be typed at the boot prompt, or entered in the lilo configuration file.h]hThe floppy driver is configured using the ‘floppy=’ option in lilo. This option can be typed at the boot prompt, or entered in the lilo configuration file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hyExample: If your kernel is called linux-2.6.9, type the following line at the lilo boot prompt (if you have a thinkpad)::h]hxExample: If your kernel is called linux-2.6.9, type the following line at the lilo boot prompt (if you have a thinkpad):}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh literal_block)}(hlinux-2.6.9 floppy=thinkpadh]hlinux-2.6.9 floppy=thinkpad}hj8sbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1j6hhhKhj hhubh)}(h\You may also enter the following line in /etc/lilo.conf, in the description of linux-2.6.9::h]h[You may also enter the following line in /etc/lilo.conf, in the description of linux-2.6.9:}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj7)}(happend = "floppy=thinkpad"h]happend = "floppy=thinkpad"}hjVsbah}(h]h ]h"]h$]h&]jFjGuh1j6hhhKhj hhubh)}(h6Several floppy related options may be given, example::h]h5Several floppy related options may be given, example:}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj7)}(hPlinux-2.6.9 floppy=daring floppy=two_fdc append = "floppy=daring floppy=two_fdc"h]hPlinux-2.6.9 floppy=daring floppy=two_fdc append = "floppy=daring floppy=two_fdc"}hjrsbah}(h]h ]h"]h$]h&]jFjGuh1j6hhhKhj hhubh)}(hIf you give options both in the lilo config file and on the boot prompt, the option strings of both places are concatenated, the boot prompt options coming last. That's why there are also options to restore the default behavior.h]hIf you give options both in the lilo config file and on the boot prompt, the option strings of both places are concatenated, the boot prompt options coming last. That’s why there are also options to restore the default behavior.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK"hj hhubeh}(h]3lilo-configuration-options-thinkpad-users-read-thisah ]h"]6lilo configuration options (thinkpad users, read this)ah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hModule configuration optionsh]hModule configuration options}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK)ubh)}(hDIf you use the floppy driver as a module, use the following syntax::h]hCIf you use the floppy driver as a module, use the following syntax:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjhhubj7)}(h"modprobe floppy floppy=""h]h"modprobe floppy floppy=""}hjsbah}(h]h ]h"]h$]h&]jFjGuh1j6hhhK-hjhhubh)}(h Example::h]hExample:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjhhubj7)}(h*modprobe floppy floppy="omnibook messages"h]h*modprobe floppy floppy="omnibook messages"}hjsbah}(h]h ]h"]h$]h&]jFjGuh1j6hhhK1hjhhubh)}(hXIf you need certain options enabled every time you load the floppy driver, you can put::h]hWIf you need certain options enabled every time you load the floppy driver, you can put:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjhhubj7)}(h)options floppy floppy="omnibook messages"h]h)options floppy floppy="omnibook messages"}hjsbah}(h]h ]h"]h$]h&]jFjGuh1j6hhhK6hjhhubh)}(h,in a configuration file in /etc/modprobe.d/.h]h,in a configuration file in /etc/modprobe.d/.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjhhubh)}(h&The floppy driver related options are:h]h&The floppy driver related options are:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hjhhubh block_quote)}(hXfloppy=asus_pci Sets the bit mask to allow only units 0 and 1. (default) floppy=daring Tells the floppy driver that you have a well behaved floppy controller. This allows more efficient and smoother operation, but may fail on certain controllers. This may speed up certain operations. floppy=0,daring Tells the floppy driver that your floppy controller should be used with caution. floppy=one_fdc Tells the floppy driver that you have only one floppy controller. (default) floppy=two_fdc / floppy=
,two_fdc Tells the floppy driver that you have two floppy controllers. The second floppy controller is assumed to be at
. This option is not needed if the second controller is at address 0x370, and if you use the 'cmos' option. floppy=thinkpad Tells the floppy driver that you have a Thinkpad. Thinkpads use an inverted convention for the disk change line. floppy=0,thinkpad Tells the floppy driver that you don't have a Thinkpad. floppy=omnibook / floppy=nodma Tells the floppy driver not to use Dma for data transfers. This is needed on HP Omnibooks, which don't have a workable DMA channel for the floppy driver. This option is also useful if you frequently get "Unable to allocate DMA memory" messages. Indeed, dma memory needs to be continuous in physical memory, and is thus harder to find, whereas non-dma buffers may be allocated in virtual memory. However, I advise against this if you have an FDC without a FIFO (8272A or 82072). 82072A and later are OK. You also need at least a 486 to use nodma. If you use nodma mode, I suggest you also set the FIFO threshold to 10 or lower, in order to limit the number of data transfer interrupts. If you have a FIFO-able FDC, the floppy driver automatically falls back on non DMA mode if no DMA-able memory can be found. If you want to avoid this, explicitly ask for 'yesdma'. floppy=yesdma Tells the floppy driver that a workable DMA channel is available. (default) floppy=nofifo Disables the FIFO entirely. This is needed if you get "Bus master arbitration error" messages from your Ethernet card (or from other devices) while accessing the floppy. floppy=usefifo Enables the FIFO. (default) floppy=,fifo_depth Sets the FIFO threshold. This is mostly relevant in DMA mode. If this is higher, the floppy driver tolerates more interrupt latency, but it triggers more interrupts (i.e. it imposes more load on the rest of the system). If this is lower, the interrupt latency should be lower too (faster processor). The benefit of a lower threshold is less interrupts. To tune the fifo threshold, switch on over/underrun messages using 'floppycontrol --messages'. Then access a floppy disk. If you get a huge amount of "Over/Underrun - retrying" messages, then the fifo threshold is too low. Try with a higher value, until you only get an occasional Over/Underrun. It is a good idea to compile the floppy driver as a module when doing this tuning. Indeed, it allows to try different fifo values without rebooting the machine for each test. Note that you need to do 'floppycontrol --messages' every time you re-insert the module. Usually, tuning the fifo threshold should not be needed, as the default (0xa) is reasonable. floppy=,,cmos Sets the CMOS type of to . This is mandatory if you have more than two floppy drives (only two can be described in the physical CMOS), or if your BIOS uses non-standard CMOS types. The CMOS types are: == ================================== 0 Use the value of the physical CMOS 1 5 1/4 DD 2 5 1/4 HD 3 3 1/2 DD 4 3 1/2 HD 5 3 1/2 ED 6 3 1/2 ED 16 unknown or not installed == ================================== (Note: there are two valid types for ED drives. This is because 5 was initially chosen to represent floppy *tapes*, and 6 for ED drives. AMI ignored this, and used 5 for ED drives. That's why the floppy driver handles both.) floppy=unexpected_interrupts Print a warning message when an unexpected interrupt is received. (default) floppy=no_unexpected_interrupts / floppy=L40SX Don't print a message when an unexpected interrupt is received. This is needed on IBM L40SX laptops in certain video modes. (There seems to be an interaction between video and floppy. The unexpected interrupts affect only performance, and can be safely ignored.) floppy=broken_dcl Don't use the disk change line, but assume that the disk was changed whenever the device node is reopened. Needed on some boxes where the disk change line is broken or unsupported. This should be regarded as a stopgap measure, indeed it makes floppy operation less efficient due to unneeded cache flushings, and slightly more unreliable. Please verify your cable, connection and jumper settings if you have any DCL problems. However, some older drives, and also some laptops are known not to have a DCL. floppy=debug Print debugging messages. floppy=messages Print informational messages for some operations (disk change notifications, warnings about over and underruns, and about autodetection). floppy=silent_dcl_clear Uses a less noisy way to clear the disk change line (which doesn't involve seeks). Implied by 'daring' option. floppy=,irq Sets the floppy IRQ to instead of 6. floppy=,dma Sets the floppy DMA channel to instead of 2. floppy=slow Use PS/2 stepping rate:: PS/2 floppies have much slower step rates than regular floppies. It's been recommended that take about 1/4 of the default speed in some more extreme cases. h]hdefinition_list)}(hhh](hdefinition_list_item)}(hIfloppy=asus_pci Sets the bit mask to allow only units 0 and 1. (default) h](hterm)}(hfloppy=asus_pcih]hfloppy=asus_pci}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhK>hj$ubh definition)}(hhh]h)}(h8Sets the bit mask to allow only units 0 and 1. (default)h]h8Sets the bit mask to allow only units 0 and 1. (default)}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hj:ubah}(h]h ]h"]h$]h&]uh1j8hj$ubeh}(h]h ]h"]h$]h&]uh1j"hhhK>hjubj#)}(hfloppy=daring Tells the floppy driver that you have a well behaved floppy controller. This allows more efficient and smoother operation, but may fail on certain controllers. This may speed up certain operations. h](j))}(h floppy=daringh]h floppy=daring}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKChjWubj9)}(hhh]h)}(hTells the floppy driver that you have a well behaved floppy controller. This allows more efficient and smoother operation, but may fail on certain controllers. This may speed up certain operations.h]hTells the floppy driver that you have a well behaved floppy controller. This allows more efficient and smoother operation, but may fail on certain controllers. This may speed up certain operations.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjiubah}(h]h ]h"]h$]h&]uh1j8hjWubeh}(h]h ]h"]h$]h&]uh1j"hhhKChjubj#)}(hafloppy=0,daring Tells the floppy driver that your floppy controller should be used with caution. h](j))}(hfloppy=0,daringh]hfloppy=0,daring}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKGhjubj9)}(hhh]h)}(hPTells the floppy driver that your floppy controller should be used with caution.h]hPTells the floppy driver that your floppy controller should be used with caution.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKGhjubj#)}(h[floppy=one_fdc Tells the floppy driver that you have only one floppy controller. (default) h](j))}(hfloppy=one_fdch]hfloppy=one_fdc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKKhjubj9)}(hhh]h)}(hKTells the floppy driver that you have only one floppy controller. (default)h]hKTells the floppy driver that you have only one floppy controller. (default)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKKhjubj#)}(hXfloppy=two_fdc / floppy=
,two_fdc Tells the floppy driver that you have two floppy controllers. The second floppy controller is assumed to be at
. This option is not needed if the second controller is at address 0x370, and if you use the 'cmos' option. h](j))}(h)floppy=two_fdc / floppy=
,two_fdch]h)floppy=two_fdc / floppy=
,two_fdc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKQhjubj9)}(hhh]h)}(hTells the floppy driver that you have two floppy controllers. The second floppy controller is assumed to be at
. This option is not needed if the second controller is at address 0x370, and if you use the 'cmos' option.h]hTells the floppy driver that you have two floppy controllers. The second floppy controller is assumed to be at
. This option is not needed if the second controller is at address 0x370, and if you use the ‘cmos’ option.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKNhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKQhjubj#)}(hfloppy=thinkpad Tells the floppy driver that you have a Thinkpad. Thinkpads use an inverted convention for the disk change line. h](j))}(hfloppy=thinkpadh]hfloppy=thinkpad}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKUhjubj9)}(hhh]h)}(hpTells the floppy driver that you have a Thinkpad. Thinkpads use an inverted convention for the disk change line.h]hpTells the floppy driver that you have a Thinkpad. Thinkpads use an inverted convention for the disk change line.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThj%ubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKUhjubj#)}(hJfloppy=0,thinkpad Tells the floppy driver that you don't have a Thinkpad. h](j))}(hfloppy=0,thinkpadh]hfloppy=0,thinkpad}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKXhjBubj9)}(hhh]h)}(h7Tells the floppy driver that you don't have a Thinkpad.h]h9Tells the floppy driver that you don’t have a Thinkpad.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjTubah}(h]h ]h"]h$]h&]uh1j8hjBubeh}(h]h ]h"]h$]h&]uh1j"hhhKXhjubj#)}(hXfloppy=omnibook / floppy=nodma Tells the floppy driver not to use Dma for data transfers. This is needed on HP Omnibooks, which don't have a workable DMA channel for the floppy driver. This option is also useful if you frequently get "Unable to allocate DMA memory" messages. Indeed, dma memory needs to be continuous in physical memory, and is thus harder to find, whereas non-dma buffers may be allocated in virtual memory. However, I advise against this if you have an FDC without a FIFO (8272A or 82072). 82072A and later are OK. You also need at least a 486 to use nodma. If you use nodma mode, I suggest you also set the FIFO threshold to 10 or lower, in order to limit the number of data transfer interrupts. If you have a FIFO-able FDC, the floppy driver automatically falls back on non DMA mode if no DMA-able memory can be found. If you want to avoid this, explicitly ask for 'yesdma'. h](j))}(hfloppy=omnibook / floppy=nodmah]hfloppy=omnibook / floppy=nodma}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKjhjqubj9)}(hhh](h)}(hXTells the floppy driver not to use Dma for data transfers. This is needed on HP Omnibooks, which don't have a workable DMA channel for the floppy driver. This option is also useful if you frequently get "Unable to allocate DMA memory" messages. Indeed, dma memory needs to be continuous in physical memory, and is thus harder to find, whereas non-dma buffers may be allocated in virtual memory. However, I advise against this if you have an FDC without a FIFO (8272A or 82072). 82072A and later are OK. You also need at least a 486 to use nodma. If you use nodma mode, I suggest you also set the FIFO threshold to 10 or lower, in order to limit the number of data transfer interrupts.h]hXTells the floppy driver not to use Dma for data transfers. This is needed on HP Omnibooks, which don’t have a workable DMA channel for the floppy driver. This option is also useful if you frequently get “Unable to allocate DMA memory” messages. Indeed, dma memory needs to be continuous in physical memory, and is thus harder to find, whereas non-dma buffers may be allocated in virtual memory. However, I advise against this if you have an FDC without a FIFO (8272A or 82072). 82072A and later are OK. You also need at least a 486 to use nodma. If you use nodma mode, I suggest you also set the FIFO threshold to 10 or lower, in order to limit the number of data transfer interrupts.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjubh)}(hIf you have a FIFO-able FDC, the floppy driver automatically falls back on non DMA mode if no DMA-able memory can be found. If you want to avoid this, explicitly ask for 'yesdma'.h]hIf you have a FIFO-able FDC, the floppy driver automatically falls back on non DMA mode if no DMA-able memory can be found. If you want to avoid this, explicitly ask for ‘yesdma’.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhjubeh}(h]h ]h"]h$]h&]uh1j8hjqubeh}(h]h ]h"]h$]h&]uh1j"hhhKjhjubj#)}(hZfloppy=yesdma Tells the floppy driver that a workable DMA channel is available. (default) h](j))}(h floppy=yesdmah]h floppy=yesdma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKnhjubj9)}(hhh]h)}(hKTells the floppy driver that a workable DMA channel is available. (default)h]hKTells the floppy driver that a workable DMA channel is available. (default)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKmhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKnhjubj#)}(hfloppy=nofifo Disables the FIFO entirely. This is needed if you get "Bus master arbitration error" messages from your Ethernet card (or from other devices) while accessing the floppy. h](j))}(h floppy=nofifoh]h floppy=nofifo}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKshjubj9)}(hhh]h)}(hDisables the FIFO entirely. This is needed if you get "Bus master arbitration error" messages from your Ethernet card (or from other devices) while accessing the floppy.h]hDisables the FIFO entirely. This is needed if you get “Bus master arbitration error” messages from your Ethernet card (or from other devices) while accessing the floppy.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKshjubj#)}(h+floppy=usefifo Enables the FIFO. (default) h](j))}(hfloppy=usefifoh]hfloppy=usefifo}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKvhj ubj9)}(hhh]h)}(hEnables the FIFO. (default)h]hEnables the FIFO. (default)}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKvhjubah}(h]h ]h"]h$]h&]uh1j8hj ubeh}(h]h ]h"]h$]h&]uh1j"hhhKvhjubj#)}(hXfloppy=,fifo_depth Sets the FIFO threshold. This is mostly relevant in DMA mode. If this is higher, the floppy driver tolerates more interrupt latency, but it triggers more interrupts (i.e. it imposes more load on the rest of the system). If this is lower, the interrupt latency should be lower too (faster processor). The benefit of a lower threshold is less interrupts. To tune the fifo threshold, switch on over/underrun messages using 'floppycontrol --messages'. Then access a floppy disk. If you get a huge amount of "Over/Underrun - retrying" messages, then the fifo threshold is too low. Try with a higher value, until you only get an occasional Over/Underrun. It is a good idea to compile the floppy driver as a module when doing this tuning. Indeed, it allows to try different fifo values without rebooting the machine for each test. Note that you need to do 'floppycontrol --messages' every time you re-insert the module. Usually, tuning the fifo threshold should not be needed, as the default (0xa) is reasonable. h](j))}(hfloppy=,fifo_depthh]hfloppy=,fifo_depth}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhj;ubj9)}(hhh](h)}(hX`Sets the FIFO threshold. This is mostly relevant in DMA mode. If this is higher, the floppy driver tolerates more interrupt latency, but it triggers more interrupts (i.e. it imposes more load on the rest of the system). If this is lower, the interrupt latency should be lower too (faster processor). The benefit of a lower threshold is less interrupts.h]hX`Sets the FIFO threshold. This is mostly relevant in DMA mode. If this is higher, the floppy driver tolerates more interrupt latency, but it triggers more interrupts (i.e. it imposes more load on the rest of the system). If this is lower, the interrupt latency should be lower too (faster processor). The benefit of a lower threshold is less interrupts.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhjMubh)}(hX/To tune the fifo threshold, switch on over/underrun messages using 'floppycontrol --messages'. Then access a floppy disk. If you get a huge amount of "Over/Underrun - retrying" messages, then the fifo threshold is too low. Try with a higher value, until you only get an occasional Over/Underrun. It is a good idea to compile the floppy driver as a module when doing this tuning. Indeed, it allows to try different fifo values without rebooting the machine for each test. Note that you need to do 'floppycontrol --messages' every time you re-insert the module.h]hX;To tune the fifo threshold, switch on over/underrun messages using ‘floppycontrol --messages’. Then access a floppy disk. If you get a huge amount of “Over/Underrun - retrying” messages, then the fifo threshold is too low. Try with a higher value, until you only get an occasional Over/Underrun. It is a good idea to compile the floppy driver as a module when doing this tuning. Indeed, it allows to try different fifo values without rebooting the machine for each test. Note that you need to do ‘floppycontrol --messages’ every time you re-insert the module.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMubh)}(h\Usually, tuning the fifo threshold should not be needed, as the default (0xa) is reasonable.h]h\Usually, tuning the fifo threshold should not be needed, as the default (0xa) is reasonable.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMubeh}(h]h ]h"]h$]h&]uh1j8hj;ubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(hXfloppy=,,cmos Sets the CMOS type of to . This is mandatory if you have more than two floppy drives (only two can be described in the physical CMOS), or if your BIOS uses non-standard CMOS types. The CMOS types are: == ================================== 0 Use the value of the physical CMOS 1 5 1/4 DD 2 5 1/4 HD 3 3 1/2 DD 4 3 1/2 HD 5 3 1/2 ED 6 3 1/2 ED 16 unknown or not installed == ================================== (Note: there are two valid types for ED drives. This is because 5 was initially chosen to represent floppy *tapes*, and 6 for ED drives. AMI ignored this, and used 5 for ED drives. That's why the floppy driver handles both.) h](j))}(hfloppy=,,cmosh]hfloppy=,,cmos}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjubj9)}(hhh](h)}(hSets the CMOS type of to . This is mandatory if you have more than two floppy drives (only two can be described in the physical CMOS), or if your BIOS uses non-standard CMOS types. The CMOS types are:h]hSets the CMOS type of to . This is mandatory if you have more than two floppy drives (only two can be described in the physical CMOS), or if your BIOS uses non-standard CMOS types. The CMOS types are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(h== ================================== 0 Use the value of the physical CMOS 1 5 1/4 DD 2 5 1/4 HD 3 3 1/2 DD 4 3 1/2 HD 5 3 1/2 ED 6 3 1/2 ED 16 unknown or not installed == ================================== h]htable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthK"uh1jhjubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h0h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h"Use the value of the physical CMOSh]h"Use the value of the physical CMOS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h5 1/4 DDh]h5 1/4 DD}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h2h]h2}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjGubah}(h]h ]h"]h$]h&]uh1jhjDubj)}(hhh]h)}(h5 1/4 HDh]h5 1/4 HD}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj^ubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h3h]h3}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj~ubah}(h]h ]h"]h$]h&]uh1jhj{ubj)}(hhh]h)}(h3 1/2 DDh]h3 1/2 DD}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h4h]h4}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h3 1/2 HDh]h3 1/2 HD}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h5h]h5}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h3 1/2 EDh]h3 1/2 ED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h6h]h6}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj#ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h3 1/2 EDh]h3 1/2 ED}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj:ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h16h]h16}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjZubah}(h]h ]h"]h$]h&]uh1jhjWubj)}(hhh]h)}(hunknown or not installedh]hunknown or not installed}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjqubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjubh)}(h(Note: there are two valid types for ED drives. This is because 5 was initially chosen to represent floppy *tapes*, and 6 for ED drives. AMI ignored this, and used 5 for ED drives. That's why the floppy driver handles both.)h](hk(Note: there are two valid types for ED drives. This is because 5 was initially chosen to represent floppy }(hjhhhNhNubhemphasis)}(h*tapes*h]htapes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhp, and 6 for ED drives. AMI ignored this, and used 5 for ED drives. That’s why the floppy driver handles both.)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(hifloppy=unexpected_interrupts Print a warning message when an unexpected interrupt is received. (default) h](j))}(hfloppy=unexpected_interruptsh]hfloppy=unexpected_interrupts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjubj9)}(hhh]h)}(hKPrint a warning message when an unexpected interrupt is received. (default)h]hKPrint a warning message when an unexpected interrupt is received. (default)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(hX6floppy=no_unexpected_interrupts / floppy=L40SX Don't print a message when an unexpected interrupt is received. This is needed on IBM L40SX laptops in certain video modes. (There seems to be an interaction between video and floppy. The unexpected interrupts affect only performance, and can be safely ignored.) h](j))}(h.floppy=no_unexpected_interrupts / floppy=L40SXh]h.floppy=no_unexpected_interrupts / floppy=L40SX}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjubj9)}(hhh]h)}(hXDon't print a message when an unexpected interrupt is received. This is needed on IBM L40SX laptops in certain video modes. (There seems to be an interaction between video and floppy. The unexpected interrupts affect only performance, and can be safely ignored.)h]hXDon’t print a message when an unexpected interrupt is received. This is needed on IBM L40SX laptops in certain video modes. (There seems to be an interaction between video and floppy. The unexpected interrupts affect only performance, and can be safely ignored.)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(hX floppy=broken_dcl Don't use the disk change line, but assume that the disk was changed whenever the device node is reopened. Needed on some boxes where the disk change line is broken or unsupported. This should be regarded as a stopgap measure, indeed it makes floppy operation less efficient due to unneeded cache flushings, and slightly more unreliable. Please verify your cable, connection and jumper settings if you have any DCL problems. However, some older drives, and also some laptops are known not to have a DCL. h](j))}(hfloppy=broken_dclh]hfloppy=broken_dcl}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhj3ubj9)}(hhh]h)}(hXDon't use the disk change line, but assume that the disk was changed whenever the device node is reopened. Needed on some boxes where the disk change line is broken or unsupported. This should be regarded as a stopgap measure, indeed it makes floppy operation less efficient due to unneeded cache flushings, and slightly more unreliable. Please verify your cable, connection and jumper settings if you have any DCL problems. However, some older drives, and also some laptops are known not to have a DCL.h]hXDon’t use the disk change line, but assume that the disk was changed whenever the device node is reopened. Needed on some boxes where the disk change line is broken or unsupported. This should be regarded as a stopgap measure, indeed it makes floppy operation less efficient due to unneeded cache flushings, and slightly more unreliable. Please verify your cable, connection and jumper settings if you have any DCL problems. However, some older drives, and also some laptops are known not to have a DCL.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjEubah}(h]h ]h"]h$]h&]uh1j8hj3ubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(h'floppy=debug Print debugging messages. h](j))}(h floppy=debugh]h floppy=debug}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjbubj9)}(hhh]h)}(hPrint debugging messages.h]hPrint debugging messages.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjtubah}(h]h ]h"]h$]h&]uh1j8hjbubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(hfloppy=messages Print informational messages for some operations (disk change notifications, warnings about over and underruns, and about autodetection). h](j))}(hfloppy=messagesh]hfloppy=messages}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjubj9)}(hhh]h)}(hPrint informational messages for some operations (disk change notifications, warnings about over and underruns, and about autodetection).h]hPrint informational messages for some operations (disk change notifications, warnings about over and underruns, and about autodetection).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(hfloppy=silent_dcl_clear Uses a less noisy way to clear the disk change line (which doesn't involve seeks). Implied by 'daring' option. h](j))}(hfloppy=silent_dcl_clearh]hfloppy=silent_dcl_clear}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjubj9)}(hhh]h)}(hnUses a less noisy way to clear the disk change line (which doesn't involve seeks). Implied by 'daring' option.h]htUses a less noisy way to clear the disk change line (which doesn’t involve seeks). Implied by ‘daring’ option.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(h:floppy=,irq Sets the floppy IRQ to instead of 6. h](j))}(hfloppy=,irqh]hfloppy=,irq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjubj9)}(hhh]h)}(h)Sets the floppy IRQ to instead of 6.h]h)Sets the floppy IRQ to instead of 6.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(hBfloppy=,dma Sets the floppy DMA channel to instead of 2. h](j))}(hfloppy=,dmah]hfloppy=,dma}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjubj9)}(hhh]h)}(h1Sets the floppy DMA channel to instead of 2.h]h1Sets the floppy DMA channel to instead of 2.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj0ubah}(h]h ]h"]h$]h&]uh1j8hjubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubj#)}(hfloppy=slow Use PS/2 stepping rate:: PS/2 floppies have much slower step rates than regular floppies. It's been recommended that take about 1/4 of the default speed in some more extreme cases. h](j))}(h floppy=slowh]h floppy=slow}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhjMubj9)}(hhh](h)}(hUse PS/2 stepping rate::h]hUse PS/2 stepping rate:}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj_ubj7)}(hPS/2 floppies have much slower step rates than regular floppies. It's been recommended that take about 1/4 of the default speed in some more extreme cases.h]hPS/2 floppies have much slower step rates than regular floppies. It's been recommended that take about 1/4 of the default speed in some more extreme cases.}hjpsbah}(h]h ]h"]h$]h&]jFjGuh1j6hhhKhj_ubeh}(h]h ]h"]h$]h&]uh1j8hjMubeh}(h]h ]h"]h$]h&]uh1j"hhhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhK=hjhhubeh}(h]module-configuration-optionsah ]h"]module configuration optionsah$]h&]uh1hhhhhhhhK)ubh)}(hhh](h)}(h2Supporting utilities and additional documentation:h]h2Supporting utilities and additional documentation:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hXSAdditional parameters of the floppy driver can be configured at runtime. Utilities which do this can be found in the fdutils package. This package also contains a new version of mtools which allows to access high capacity disks (up to 1992K on a high density 3 1/2 disk!). It also contains additional documentation about the floppy driver.h]hXSAdditional parameters of the floppy driver can be configured at runtime. Utilities which do this can be found in the fdutils package. This package also contains a new version of mtools which allows to access high capacity disks (up to 1992K on a high density 3 1/2 disk!). It also contains additional documentation about the floppy driver.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h4The latest version can be found at fdutils homepage:h]h4The latest version can be found at fdutils homepage:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhttps://fdutils.linux.lu h]h)}(hhttps://fdutils.linux.luh]h)}(hjh]hhttps://fdutils.linux.lu}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1hhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubh)}(h%The fdutils releases can be found at:h]h%The fdutils releases can be found at:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhttps://fdutils.linux.lu/download.html http://www.tux.org/pub/knaff/fdutils/ ftp://metalab.unc.edu/pub/Linux/utils/disk-management/ h](h)}(h&https://fdutils.linux.lu/download.htmlh]h)}(hj h]h&https://fdutils.linux.lu/download.html}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurij uh1hhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(h%http://www.tux.org/pub/knaff/fdutils/h]h)}(hj h]h%http://www.tux.org/pub/knaff/fdutils/}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurij uh1hhj ubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(h6ftp://metalab.unc.edu/pub/Linux/utils/disk-management/h]h)}(hj1 h]h6ftp://metalab.unc.edu/pub/Linux/utils/disk-management/}(hj3 hhhNhNubah}(h]h ]h"]h$]h&]refurij1 uh1hhj/ ubah}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]1supporting-utilities-and-additional-documentationah ]h"]2supporting utilities and additional documentation:ah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h*Reporting problems about the floppy driverh]h*Reporting problems about the floppy driver}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjU hhhhhKubh)}(hXIf you have a question or a bug report about the floppy driver, mail me at Alain.Knaff@poboxes.com . If you post to Usenet, preferably use comp.os.linux.hardware. As the volume in these groups is rather high, be sure to include the word "floppy" (or "FLOPPY") in the subject line. If the reported problem happens when mounting floppy disks, be sure to mention also the type of the filesystem in the subject line.h](hKIf you have a question or a bug report about the floppy driver, mail me at }(hjf hhhNhNubh)}(hAlain.Knaff@poboxes.comh]hAlain.Knaff@poboxes.com}(hjn hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:Alain.Knaff@poboxes.comuh1hhjf ubhXC . If you post to Usenet, preferably use comp.os.linux.hardware. As the volume in these groups is rather high, be sure to include the word “floppy” (or “FLOPPY”) in the subject line. If the reported problem happens when mounting floppy disks, be sure to mention also the type of the filesystem in the subject line.}(hjf hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjU hhubh)}(h?Be sure to read the FAQ before mailing/posting any bug reports!h]h?Be sure to read the FAQ before mailing/posting any bug reports!}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjU hhubh)}(hAlainh]hAlain}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjU hhubeh}(h]*reporting-problems-about-the-floppy-driverah ]h"]*reporting problems about the floppy driverah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Changelogh]h Changelog}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubj)}(hhh](j#)}(hj10-30-2004 : Cleanup, updating, add reference to module configuration. James Nelson h](j))}(h 10-30-2004 :h]h 10-30-2004 :}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhj ubj9)}(hhh]h)}(h\Cleanup, updating, add reference to module configuration. James Nelson h](hHCleanup, updating, add reference to module configuration. James Nelson <}(hj hhhNhNubh)}(hjames4765@gmail.comh]hjames4765@gmail.com}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:james4765@gmail.comuh1hhj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j8hj ubeh}(h]h ]h"]h$]h&]uh1j"hhhKhj ubj#)}(h6-3-2000 : Original Documenth](j))}(h 6-3-2000 :h]h 6-3-2000 :}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j(hhhKhj ubj9)}(hhh]h)}(hOriginal Documenth]hOriginal Document}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j8hj ubeh}(h]h ]h"]h$]h&]uh1j"hhhKhj hhubeh}(h]h ]h"]h$]h&]uh1jhj hhhhhNubeh}(h] changelogah ]h"] changelogah$]h&]uh1hhhhhhhhKubeh}(h] floppy-driverah ]h"] floppy driverah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehʌ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jE jB jjjjjjjR jO j j j= j: u nametypes}(jE jjjjR j j= uh}(jB hjhjj jjjO jj jU j: j u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.