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/filesystems/journallingmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/zh_TW/filesystems/journallingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/it_IT/filesystems/journallingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/ja_JP/filesystems/journallingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/ko_KR/filesystems/journallingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/pt_BR/filesystems/journallingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget+/translations/sp_SP/filesystems/journallingmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hThe Linux Journalling APIh]hThe Linux Journalling API}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhE/var/lib/git/docbuild/linux/Documentation/filesystems/journalling.rsthKubh)}(hhh](h)}(hOverviewh]hOverview}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hDetailsh]hDetails}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hXBThe journalling layer is easy to use. You need to first of all create a journal_t data structure. There are two calls to do this dependent on how you decide to allocate the physical media on which the journal resides. The jbd2_journal_init_inode() call is for journals stored in filesystem inodes, or the jbd2_journal_init_dev() call can be used for journal stored on a raw device (in a continuous range of blocks). A journal_t is a typedef for a struct pointer, so when you are finally finished make sure you call jbd2_journal_destroy() on it to free up any used kernel memory.h]hXBThe journalling layer is easy to use. You need to first of all create a journal_t data structure. There are two calls to do this dependent on how you decide to allocate the physical media on which the journal resides. The jbd2_journal_init_inode() call is for journals stored in filesystem inodes, or the jbd2_journal_init_dev() call can be used for journal stored on a raw device (in a continuous range of blocks). A journal_t is a typedef for a struct pointer, so when you are finally finished make sure you call jbd2_journal_destroy() on it to free up any used kernel memory.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hX Once you have got your journal_t object you need to 'mount' or load the journal file. The journalling layer expects the space for the journal was already allocated and initialized properly by the userspace tools. When loading the journal you must call jbd2_journal_load() to process journal contents. If the client file system detects the journal contents does not need to be processed (or even need not have valid contents), it may call jbd2_journal_wipe() to clear the journal contents before calling jbd2_journal_load().h]hXOnce you have got your journal_t object you need to ‘mount’ or load the journal file. The journalling layer expects the space for the journal was already allocated and initialized properly by the userspace tools. When loading the journal you must call jbd2_journal_load() to process journal contents. If the client file system detects the journal contents does not need to be processed (or even need not have valid contents), it may call jbd2_journal_wipe() to clear the journal contents before calling jbd2_journal_load().}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hX1Note that jbd2_journal_wipe(..,0) calls jbd2_journal_skip_recovery() for you if it detects any outstanding transactions in the journal and similarly jbd2_journal_load() will call jbd2_journal_recover() if necessary. I would advise reading ext4_load_journal() in fs/ext4/super.c for examples on this stage.h]hX1Note that jbd2_journal_wipe(..,0) calls jbd2_journal_skip_recovery() for you if it detects any outstanding transactions in the journal and similarly jbd2_journal_load() will call jbd2_journal_recover() if necessary. I would advise reading ext4_load_journal() in fs/ext4/super.c for examples on this stage.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hKNow you can go ahead and start modifying the underlying filesystem. Almost.h]hKNow you can go ahead and start modifying the underlying filesystem. Almost.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hhhhubh)}(hX`You still need to actually journal your filesystem changes, this is done by wrapping them into transactions. Additionally you also need to wrap the modification of each of the buffers with calls to the journal layer, so it knows what the modifications you are actually making are. To do this use jbd2_journal_start() which returns a transaction handle.h]hX`You still need to actually journal your filesystem changes, this is done by wrapping them into transactions. Additionally you also need to wrap the modification of each of the buffers with calls to the journal layer, so it knows what the modifications you are actually making are. To do this use jbd2_journal_start() which returns a transaction handle.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hhhhubh)}(hXjbd2_journal_start() and its counterpart jbd2_journal_stop(), which indicates the end of a transaction are nestable calls, so you can reenter a transaction if necessary, but remember you must call jbd2_journal_stop() the same number of times as jbd2_journal_start() before the transaction is completed (or more accurately leaves the update phase). Ext4/VFS makes use of this feature to simplify handling of inode dirtying, quota support, etc.h]hXjbd2_journal_start() and its counterpart jbd2_journal_stop(), which indicates the end of a transaction are nestable calls, so you can reenter a transaction if necessary, but remember you must call jbd2_journal_stop() the same number of times as jbd2_journal_start() before the transaction is completed (or more accurately leaves the update phase). Ext4/VFS makes use of this feature to simplify handling of inode dirtying, quota support, etc.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hhhhubh)}(hXInside each transaction you need to wrap the modifications to the individual buffers (blocks). Before you start to modify a buffer you need to call jbd2_journal_get_create_access() / jbd2_journal_get_write_access() / jbd2_journal_get_undo_access() as appropriate, this allows the journalling layer to copy the unmodified data if it needs to. After all the buffer may be part of a previously uncommitted transaction. At this point you are at last ready to modify a buffer, and once you are have done so you need to call jbd2_journal_dirty_metadata(). Or if you've asked for access to a buffer you now know is now longer required to be pushed back on the device you can call jbd2_journal_forget() in much the same way as you might have used bforget() in the past.h]hXInside each transaction you need to wrap the modifications to the individual buffers (blocks). Before you start to modify a buffer you need to call jbd2_journal_get_create_access() / jbd2_journal_get_write_access() / jbd2_journal_get_undo_access() as appropriate, this allows the journalling layer to copy the unmodified data if it needs to. After all the buffer may be part of a previously uncommitted transaction. At this point you are at last ready to modify a buffer, and once you are have done so you need to call jbd2_journal_dirty_metadata(). Or if you’ve asked for access to a buffer you now know is now longer required to be pushed back on the device you can call jbd2_journal_forget() in much the same way as you might have used bforget() in the past.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hhhhubh)}(h`A jbd2_journal_flush() may be called at any time to commit and checkpoint all your transactions.h]h`A jbd2_journal_flush() may be called at any time to commit and checkpoint all your transactions.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhhhhubh)}(h{Then at umount time , in your put_super() you can then call jbd2_journal_destroy() to clean up your in-core journal object.h]h{Then at umount time , in your put_super() you can then call jbd2_journal_destroy() to clean up your in-core journal object.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhhhhubh)}(hXHUnfortunately there a couple of ways the journal layer can cause a deadlock. The first thing to note is that each task can only have a single outstanding transaction at any one time, remember nothing commits until the outermost jbd2_journal_stop(). This means you must complete the transaction at the end of each file/inode/address etc. operation you perform, so that the journalling system isn't re-entered on another journal. Since transactions can't be nested/batched across differing journals, and another filesystem other than yours (say ext4) may be modified in a later syscall.h]hXLUnfortunately there a couple of ways the journal layer can cause a deadlock. The first thing to note is that each task can only have a single outstanding transaction at any one time, remember nothing commits until the outermost jbd2_journal_stop(). This means you must complete the transaction at the end of each file/inode/address etc. operation you perform, so that the journalling system isn’t re-entered on another journal. Since transactions can’t be nested/batched across differing journals, and another filesystem other than yours (say ext4) may be modified in a later syscall.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhhhhubh)}(hXThe second case to bear in mind is that jbd2_journal_start() can block if there isn't enough space in the journal for your transaction (based on the passed nblocks param) - when it blocks it merely(!) needs to wait for transactions to complete and be committed from other tasks, so essentially we are waiting for jbd2_journal_stop(). So to avoid deadlocks you must treat jbd2_journal_start() / jbd2_journal_stop() as if they were semaphores and include them in your semaphore ordering rules to prevent deadlocks. Note that jbd2_journal_extend() has similar blocking behaviour to jbd2_journal_start() so you can deadlock here just as easily as on jbd2_journal_start().h]hXThe second case to bear in mind is that jbd2_journal_start() can block if there isn’t enough space in the journal for your transaction (based on the passed nblocks param) - when it blocks it merely(!) needs to wait for transactions to complete and be committed from other tasks, so essentially we are waiting for jbd2_journal_stop(). So to avoid deadlocks you must treat jbd2_journal_start() / jbd2_journal_stop() as if they were semaphores and include them in your semaphore ordering rules to prevent deadlocks. Note that jbd2_journal_extend() has similar blocking behaviour to jbd2_journal_start() so you can deadlock here just as easily as on jbd2_journal_start().}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhhhhubh)}(hTry to reserve the right number of blocks the first time. ;-). This will be the maximum number of blocks you are going to touch in this transaction. I advise having a look at at least ext4_jbd.h to see the basis on which ext4 uses to make these decisions.h]hTry to reserve the right number of blocks the first time. ;-). This will be the maximum number of blocks you are going to touch in this transaction. I advise having a look at at least ext4_jbd.h to see the basis on which ext4 uses to make these decisions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hhhhubh)}(hXQAnother wriggle to watch out for is your on-disk block allocation strategy. Why? Because, if you do a delete, you need to ensure you haven't reused any of the freed blocks until the transaction freeing these blocks commits. If you reused these blocks and crash happens, there is no way to restore the contents of the reallocated blocks at the end of the last fully committed transaction. One simple way of doing this is to mark blocks as free in internal in-memory block allocation structures only after the transaction freeing them commits. Ext4 uses journal commit callback for this purpose.h]hXSAnother wriggle to watch out for is your on-disk block allocation strategy. Why? Because, if you do a delete, you need to ensure you haven’t reused any of the freed blocks until the transaction freeing these blocks commits. If you reused these blocks and crash happens, there is no way to restore the contents of the reallocated blocks at the end of the last fully committed transaction. One simple way of doing this is to mark blocks as free in internal in-memory block allocation structures only after the transaction freeing them commits. Ext4 uses journal commit callback for this purpose.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchhhhubh)}(hXrWith journal commit callbacks you can ask the journalling layer to call a callback function when the transaction is finally committed to disk, so that you can do some of your own management. You ask the journalling layer for calling the callback by simply setting ``journal->j_commit_callback`` function pointer and that function is called after each transaction commit.h](hXWith journal commit callbacks you can ask the journalling layer to call a callback function when the transaction is finally committed to disk, so that you can do some of your own management. You ask the journalling layer for calling the callback by simply setting }(hjhhhNhNubhliteral)}(h``journal->j_commit_callback``h]hjournal->j_commit_callback}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhL function pointer and that function is called after each transaction commit.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKmhhhhubh)}(hJBD2 also provides a way to block all transaction updates via jbd2_journal_lock_updates() / jbd2_journal_unlock_updates(). Ext4 uses this when it wants a window with a clean and stable fs for a moment. E.g.h]hJBD2 also provides a way to block all transaction updates via jbd2_journal_lock_updates() / jbd2_journal_unlock_updates(). Ext4 uses this when it wants a window with a clean and stable fs for a moment. E.g.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthhhhubh literal_block)}(hjbd2_journal_lock_updates() //stop new stuff happening.. jbd2_journal_flush() // checkpoint everything. ..do stuff on stable fs jbd2_journal_unlock_updates() // carry on with filesystem use.h]hjbd2_journal_lock_updates() //stop new stuff happening.. jbd2_journal_flush() // checkpoint everything. ..do stuff on stable fs jbd2_journal_unlock_updates() // carry on with filesystem use.}hjsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1jhhhK|hhhhubh)}(hThe opportunities for abuse and DOS attacks with this should be obvious, if you allow unprivileged userspace to trigger codepaths containing these calls.h]hThe opportunities for abuse and DOS attacks with this should be obvious, if you allow unprivileged userspace to trigger codepaths containing these calls.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]detailsah ]h"]detailsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Fast commitsh]h Fast commits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hJBD2 to also allows you to perform file-system specific delta commits known as fast commits. In order to use fast commits, you will need to set following callbacks that perform corresponding work:h]hJBD2 to also allows you to perform file-system specific delta commits known as fast commits. In order to use fast commits, you will need to set following callbacks that perform corresponding work:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h\`journal->j_fc_cleanup_cb`: Cleanup function called after every full commit and fast commit.h](htitle_reference)}(h`journal->j_fc_cleanup_cb`h]hjournal->j_fc_cleanup_cb}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j hjubhB: Cleanup function called after every full commit and fast commit.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hS`journal->j_fc_replay_cb`: Replay function called for replay of fast commit blocks.h](j!)}(h`journal->j_fc_replay_cb`h]hjournal->j_fc_replay_cb}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1j hj:ubh:: Replay function called for replay of fast commit blocks.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXcFile system is free to perform fast commits as and when it wants as long as it gets permission from JBD2 to do so by calling the function :c:func:`jbd2_fc_begin_commit()`. Once a fast commit is done, the client file system should tell JBD2 about it by calling :c:func:`jbd2_fc_end_commit()`. If the file system wants JBD2 to perform a full commit immediately after stopping the fast commit it can do so by calling :c:func:`jbd2_fc_end_commit_fallback()`. This is useful if fast commit operation fails for some reason and the only way to guarantee consistency is for JBD2 to perform the full traditional commit.h](hFile system is free to perform fast commits as and when it wants as long as it gets permission from JBD2 to do so by calling the function }(hjVhhhNhNubh)}(h :c:func:`jbd2_fc_begin_commit()`h]j)}(hj`h]hjbd2_fc_begin_commit()}(hjbhhhNhNubah}(h]h ](xrefcc-funceh"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]refdocfilesystems/journalling refdomainjmreftypefunc refexplicitrefwarn reftargetjbd2_fc_begin_commituh1hhhhKhjVubh[. Once a fast commit is done, the client file system should tell JBD2 about it by calling }(hjVhhhNhNubh)}(h:c:func:`jbd2_fc_end_commit()`h]j)}(hjh]hjbd2_fc_end_commit()}(hjhhhNhNubah}(h]h ](jljmc-funceh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocjy refdomainjmreftypefunc refexplicitrefwarnjjbd2_fc_end_commituh1hhhhKhjVubh|. If the file system wants JBD2 to perform a full commit immediately after stopping the fast commit it can do so by calling }(hjVhhhNhNubh)}(h':c:func:`jbd2_fc_end_commit_fallback()`h]j)}(hjh]hjbd2_fc_end_commit_fallback()}(hjhhhNhNubah}(h]h ](jljmc-funceh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocjy refdomainjmreftypefunc refexplicitrefwarnjjbd2_fc_end_commit_fallbackuh1hhhhKhjVubh. This is useful if fast commit operation fails for some reason and the only way to guarantee consistency is for JBD2 to perform the full traditional commit.}(hjVhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hJBD2 helper functions to manage fast commit buffers. File system can use :c:func:`jbd2_fc_get_buf()` and :c:func:`jbd2_fc_wait_bufs()` to allocate and wait on IO completion of fast commit buffers.h](hIJBD2 helper functions to manage fast commit buffers. File system can use }(hjhhhNhNubh)}(h:c:func:`jbd2_fc_get_buf()`h]j)}(hjh]hjbd2_fc_get_buf()}(hjhhhNhNubah}(h]h ](jljmc-funceh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocjy refdomainjmreftypefunc refexplicitrefwarnjjbd2_fc_get_bufuh1hhhhKhjubh and }(hjhhhNhNubh)}(h:c:func:`jbd2_fc_wait_bufs()`h]j)}(hjh]hjbd2_fc_wait_bufs()}(hjhhhNhNubah}(h]h ](jljmc-funceh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocjy refdomainjmreftypefunc refexplicitrefwarnjjbd2_fc_wait_bufsuh1hhhhKhjubh> to allocate and wait on IO completion of fast commit buffers.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hCurrently, only Ext4 implements fast commits. For details of its implementation of fast commits, please refer to the top level comments in fs/ext4/fast_commit.c.h]hCurrently, only Ext4 implements fast commits. For details of its implementation of fast commits, please refer to the top level comments in fs/ext4/fast_commit.c.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] fast-commitsah ]h"] fast commitsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hSummaryh]hSummary}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hhhhhKubh)}(hUsing the journal is a matter of wrapping the different context changes, being each mount, each modification (transaction) and each changed buffer to tell the journalling layer about them.h]hUsing the journal is a matter of wrapping the different context changes, being each mount, each modification (transaction) and each changed buffer to tell the journalling layer about them.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj;hhubeh}(h]summaryah ]h"]summaryah$]h&]uh1hhhhhhhhKubeh}(h]overviewah ]h"]overviewah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Data Typesh]h Data Types}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhhhhhKubh)}(hThe journalling layer uses typedefs to 'hide' the concrete definitions of the structures used. As a client of the JBD2 layer you can just rely on the using the pointer as a magic cookie of some sort. Obviously the hiding is not enforced as this is 'C'.h]hXThe journalling layer uses typedefs to ‘hide’ the concrete definitions of the structures used. As a client of the JBD2 layer you can just rely on the using the pointer as a magic cookie of some sort. Obviously the hiding is not enforced as this is ‘C’.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjjhhubh)}(hhh](h)}(h Structuresh]h Structures}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlehandle_t (C type) c.handle_thNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(hhandle_th]hdesc_signature_line)}(h type handle_th](hdesc_sig_keyword)}(htypeh]htype}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjhhh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhKubh desc_name)}(hhandle_th]h desc_sig_name)}(hjh]hhandle_t}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]jjuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]jj add_permalinkuh1jsphinx_line_type declaratorhjhhhjhKubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhKhjhhubh desc_content)}(hhh]h)}(hTThe handle_t type represents a single atomic update being performed by some process.h]hTThe handle_t type represents a single atomic update being performed by some process.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKHhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jmtypeeh"]h$]h&]domainjmobjtypej.desctypej.noindex noindexentrynocontentsentryuh1jhhhjhNhNubh)}(h**Description**h]hstrong)}(hj:h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj8ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKJhjhhubh)}(hAll filesystem modifications made by the process go through this handle. Recursive operations (such as quota operations) are gathered into a single update.h]hAll filesystem modifications made by the process go through this handle. Recursive operations (such as quota operations) are gathered into a single update.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKIhjhhubh)}(hXThe buffer credits field is used to account for journaled buffers being modified by the running process. To ensure that there is enough log space for all outstanding operations, we need to limit the number of outstanding buffers possible at any time. When the operation completes, any buffer credits not used are credited back to the transaction, so that at all times we know how many buffers the outstanding updates on a transaction might possibly touch.h]hXThe buffer credits field is used to account for journaled buffers being modified by the running process. To ensure that there is enough log space for all outstanding operations, we need to limit the number of outstanding buffers possible at any time. When the operation completes, any buffer credits not used are credited back to the transaction, so that at all times we know how many buffers the outstanding updates on a transaction might possibly touch.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKMhjhhubh)}(hThis is an opaque datatype.h]hThis is an opaque datatype.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKUhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjournal_t (C type) c.journal_thNtauh1jhjhhhNhNubj)}(hhh](j)}(h journal_th]j)}(htype journal_th](j)}(hjh]htype}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKZubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKZubj)}(h journal_th]j)}(hjh]h journal_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhjhKZubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjhhhjhKZubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jhjhKZhjhhubj)}(hhh]h)}(hXThe journal_t maintains all of the journaling state information for a single filesystem.h]hXThe journal_t maintains all of the journaling state information for a single filesystem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhK\hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKZubeh}(h]h ](jmtypeeh"]h$]h&]j2jmj3jj4jj5j6j7uh1jhhhjhNhNubh)}(h**Description**h]j=)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhK^hjhhubh)}(h8journal_t is linked to from the fs superblock structure.h]h8journal_t is linked to from the fs superblock structure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhK]hjhhubh)}(hWe use the journal_t to keep track of all outstanding transaction activity on the filesystem, and to manage the state of the log writing process.h]hWe use the journal_t to keep track of all outstanding transaction activity on the filesystem, and to manage the state of the log writing process.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhK_hjhhubh)}(hThis is an opaque datatype.h]hThis is an opaque datatype.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKchjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_inode (C struct) c.jbd2_inodehNtauh1jhjhhhNhNubj)}(hhh](j)}(h jbd2_inodeh]j)}(hstruct jbd2_inodeh](j)}(hstructh]hstruct}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPhhh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKhubj)}(h h]h }(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPhhhjbhKhubj)}(h jbd2_inodeh]j)}(hjNh]h jbd2_inode}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubah}(h]h ](jjeh"]h$]h&]jjuh1jhjPhhhjbhKhubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjLhhhjbhKhubah}(h]jGah ](j j eh"]h$]h&]jj)jhuh1jhjbhKhhjIhhubj)}(hhh]h)}(hThe jbd_inode type is the structure linking inodes in ordered mode present in a transaction so that we can sync them during commit.h]hThe jbd_inode type is the structure linking inodes in ordered mode present in a transaction so that we can sync them during commit.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhjIhhhjbhKhubeh}(h]h ](jmstructeh"]h$]h&]j2jmj3jj4jj5j6j7uh1jhhhjhNhNubh container)}(hX(**Definition**:: struct jbd2_inode { transaction_t *i_transaction; transaction_t *i_next_transaction; struct list_head i_list; struct inode *i_vfs_inode; unsigned long i_flags; pgoff_t i_dirty_start_page; pgoff_t i_dirty_end_page; }; **Members** ``i_transaction`` Which transaction does this inode belong to? Either the running transaction or the committing one. [j_list_lock] ``i_next_transaction`` Pointer to the running transaction modifying inode's data in case there is already a committing transaction touching it. [j_list_lock] ``i_list`` List of inodes in the i_transaction [j_list_lock] ``i_vfs_inode`` VFS inode this inode belongs to [constant for lifetime of structure] ``i_flags`` Flags of inode [j_list_lock] ``i_dirty_start_page`` Dirty range start in PAGE_SIZE units. The dirty range is empty if **i_dirty_start_page** is greater than or equal to **i_dirty_end_page**. [j_list_lock] ``i_dirty_end_page`` Dirty range end in PAGE_SIZE units (exclusive). [j_list_lock]h](h)}(h**Definition**::h](j=)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj)}(hstruct jbd2_inode { transaction_t *i_transaction; transaction_t *i_next_transaction; struct list_head i_list; struct inode *i_vfs_inode; unsigned long i_flags; pgoff_t i_dirty_start_page; pgoff_t i_dirty_end_page; };h]hstruct jbd2_inode { transaction_t *i_transaction; transaction_t *i_next_transaction; struct list_head i_list; struct inode *i_vfs_inode; unsigned long i_flags; pgoff_t i_dirty_start_page; pgoff_t i_dirty_end_page; };}hjsbah}(h]h ]h"]h$]h&]jjuh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubh)}(h **Members**h]j=)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubhdefinition_list)}(hhh](hdefinition_list_item)}(h``i_transaction`` Which transaction does this inode belong to? Either the running transaction or the committing one. [j_list_lock] h](hterm)}(h``i_transaction``h]j)}(hj h]h i_transaction}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubh definition)}(hhh]h)}(hpWhich transaction does this inode belong to? Either the running transaction or the committing one. [j_list_lock]h]hpWhich transaction does this inode belong to? Either the running transaction or the committing one. [j_list_lock]}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj$ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj!hMhjubj)}(h``i_next_transaction`` Pointer to the running transaction modifying inode's data in case there is already a committing transaction touching it. [j_list_lock] h](j )}(h``i_next_transaction``h]j)}(hjHh]hi_next_transaction}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjBubj#)}(hhh]h)}(hPointer to the running transaction modifying inode's data in case there is already a committing transaction touching it. [j_list_lock]h]hPointer to the running transaction modifying inode’s data in case there is already a committing transaction touching it. [j_list_lock]}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj^ubah}(h]h ]h"]h$]h&]uh1j"hjBubeh}(h]h ]h"]h$]h&]uh1jhj]hMhjubj)}(h=``i_list`` List of inodes in the i_transaction [j_list_lock] h](j )}(h ``i_list``h]j)}(hjh]hi_list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj|ubj#)}(hhh]h)}(h1List of inodes in the i_transaction [j_list_lock]h]h1List of inodes in the i_transaction [j_list_lock]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hj|ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hU``i_vfs_inode`` VFS inode this inode belongs to [constant for lifetime of structure] h](j )}(h``i_vfs_inode``h]j)}(hjh]h i_vfs_inode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hDVFS inode this inode belongs to [constant for lifetime of structure]h]hDVFS inode this inode belongs to [constant for lifetime of structure]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h)``i_flags`` Flags of inode [j_list_lock] h](j )}(h ``i_flags``h]j)}(hjh]hi_flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hFlags of inode [j_list_lock]h]hFlags of inode [j_list_lock]}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h``i_dirty_start_page`` Dirty range start in PAGE_SIZE units. The dirty range is empty if **i_dirty_start_page** is greater than or equal to **i_dirty_end_page**. [j_list_lock] h](j )}(h``i_dirty_start_page``h]j)}(hj-h]hi_dirty_start_page}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj'ubj#)}(hhh](h)}(h%Dirty range start in PAGE_SIZE units.h]h%Dirty range start in PAGE_SIZE units.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjCubh)}(hdThe dirty range is empty if **i_dirty_start_page** is greater than or equal to **i_dirty_end_page**.h](hThe dirty range is empty if }(hjUhhhNhNubj=)}(h**i_dirty_start_page**h]hi_dirty_start_page}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjUubh is greater than or equal to }(hjUhhhNhNubj=)}(h**i_dirty_end_page**h]hi_dirty_end_page}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjUubh.}(hjUhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjCubh)}(h [j_list_lock]h]h [j_list_lock]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhMhjCubeh}(h]h ]h"]h$]h&]uh1j"hj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhMhjubj)}(hS``i_dirty_end_page`` Dirty range end in PAGE_SIZE units (exclusive). [j_list_lock]h](j )}(h``i_dirty_end_page``h]j)}(hjh]hi_dirty_end_page}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh](h)}(h/Dirty range end in PAGE_SIZE units (exclusive).h]h/Dirty range end in PAGE_SIZE units (exclusive).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubh)}(h [j_list_lock]h]h [j_list_lock]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubeh}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_journal_handle (C struct)c.jbd2_journal_handlehNtauh1jhjhhhNhNubj)}(hhh](j)}(hjbd2_journal_handleh]j)}(hstruct jbd2_journal_handleh](j)}(hjVh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhjhMubj)}(hjbd2_journal_handleh]j)}(hj h]hjbd2_journal_handle}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj hhhjhMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj hhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jhjhMhjhhubj)}(hhh]h)}(hKThe jbd2_journal_handle type is the concrete type associated with handle_t.h]hKThe jbd2_journal_handle type is the concrete type associated with handle_t.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjPhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jmstructeh"]h$]h&]j2jmj3jkj4jkj5j6j7uh1jhhhjhNhNubj)}(hX**Definition**:: struct jbd2_journal_handle { union { transaction_t *h_transaction; journal_t *h_journal; }; handle_t *h_rsv_handle; int h_total_credits; int h_revoke_credits; int h_revoke_credits_requested; int h_ref; int h_err; unsigned char h_sync: 1; unsigned char h_reserved: 1; unsigned char h_aborted: 1; unsigned char h_invalid: 1; unsigned char h_type; unsigned short h_line_no; unsigned long h_start_jiffies; unsigned int h_requested_credits; unsigned int saved_alloc_context; }; **Members** ``{unnamed_union}`` anonymous ``h_transaction`` Which compound transaction is this update a part of? ``h_journal`` Which journal handle belongs to - used iff h_reserved set. ``h_rsv_handle`` Handle reserved for finishing the logical operation. ``h_total_credits`` Number of remaining buffers we are allowed to add to journal. These are dirty buffers and revoke descriptor blocks. ``h_revoke_credits`` Number of remaining revoke records available for handle ``h_revoke_credits_requested`` Holds **h_revoke_credits** after handle is started. ``h_ref`` Reference count on this handle. ``h_err`` Field for caller's use to track errors through large fs operations. ``h_sync`` Flag for sync-on-close. ``h_reserved`` Flag for handle for reserved credits. ``h_aborted`` Flag indicating fatal error on handle. ``h_type`` For handle statistics. ``h_line_no`` For handle statistics. ``h_start_jiffies`` Handle Start time. ``h_requested_credits`` Holds **h_total_credits** after handle is started. ``saved_alloc_context`` Saved context while transaction is open.h](h)}(h**Definition**::h](j=)}(h**Definition**h]h Definition}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjsubh:}(hjshhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjoubj)}(hXmstruct jbd2_journal_handle { union { transaction_t *h_transaction; journal_t *h_journal; }; handle_t *h_rsv_handle; int h_total_credits; int h_revoke_credits; int h_revoke_credits_requested; int h_ref; int h_err; unsigned char h_sync: 1; unsigned char h_reserved: 1; unsigned char h_aborted: 1; unsigned char h_invalid: 1; unsigned char h_type; unsigned short h_line_no; unsigned long h_start_jiffies; unsigned int h_requested_credits; unsigned int saved_alloc_context; };h]hXmstruct jbd2_journal_handle { union { transaction_t *h_transaction; journal_t *h_journal; }; handle_t *h_rsv_handle; int h_total_credits; int h_revoke_credits; int h_revoke_credits_requested; int h_ref; int h_err; unsigned char h_sync: 1; unsigned char h_reserved: 1; unsigned char h_aborted: 1; unsigned char h_invalid: 1; unsigned char h_type; unsigned short h_line_no; unsigned long h_start_jiffies; unsigned int h_requested_credits; unsigned int saved_alloc_context; };}hjsbah}(h]h ]h"]h$]h&]jjuh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjoubh)}(h **Members**h]j=)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjoubj)}(hhh](j)}(h``{unnamed_union}`` anonymous h](j )}(h``{unnamed_union}``h]j)}(hjh]h{unnamed_union}}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhKhjubj#)}(hhh]h)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hG``h_transaction`` Which compound transaction is this update a part of? h](j )}(h``h_transaction``h]j)}(hjh]h h_transaction}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h4Which compound transaction is this update a part of?h]h4Which compound transaction is this update a part of?}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(hI``h_journal`` Which journal handle belongs to - used iff h_reserved set. h](j )}(h ``h_journal``h]j)}(hj2 h]h h_journal}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0 ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj, ubj#)}(hhh]h)}(h:Which journal handle belongs to - used iff h_reserved set.h]h:Which journal handle belongs to - used iff h_reserved set.}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjG hMhjH ubah}(h]h ]h"]h$]h&]uh1j"hj, ubeh}(h]h ]h"]h$]h&]uh1jhjG hMhjubj)}(hF``h_rsv_handle`` Handle reserved for finishing the logical operation. h](j )}(h``h_rsv_handle``h]j)}(hjk h]h h_rsv_handle}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhje ubj#)}(hhh]h)}(h4Handle reserved for finishing the logical operation.h]h4Handle reserved for finishing the logical operation.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hje ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h``h_total_credits`` Number of remaining buffers we are allowed to add to journal. These are dirty buffers and revoke descriptor blocks. h](j )}(h``h_total_credits``h]j)}(hj h]hh_total_credits}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(hsNumber of remaining buffers we are allowed to add to journal. These are dirty buffers and revoke descriptor blocks.h]hsNumber of remaining buffers we are allowed to add to journal. These are dirty buffers and revoke descriptor blocks.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(hM``h_revoke_credits`` Number of remaining revoke records available for handle h](j )}(h``h_revoke_credits``h]j)}(hj h]hh_revoke_credits}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(h7Number of remaining revoke records available for handleh]h7Number of remaining revoke records available for handle}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(hS``h_revoke_credits_requested`` Holds **h_revoke_credits** after handle is started. h](j )}(h``h_revoke_credits_requested``h]j)}(hj h]hh_revoke_credits_requested}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(h3Holds **h_revoke_credits** after handle is started.h](hHolds }(hj0 hhhNhNubj=)}(h**h_revoke_credits**h]hh_revoke_credits}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj0 ubh after handle is started.}(hj0 hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj, hMhj- ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj, hMhjubj)}(h*``h_ref`` Reference count on this handle. h](j )}(h ``h_ref``h]j)}(hjb h]hh_ref}(hjd hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj` ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj\ ubj#)}(hhh]h)}(hReference count on this handle.h]hReference count on this handle.}(hj{ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjw hMhjx ubah}(h]h ]h"]h$]h&]uh1j"hj\ ubeh}(h]h ]h"]h$]h&]uh1jhjw hMhjubj)}(hN``h_err`` Field for caller's use to track errors through large fs operations. h](j )}(h ``h_err``h]j)}(hj h]hh_err}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(hCField for caller's use to track errors through large fs operations.h]hEField for caller’s use to track errors through large fs operations.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h#``h_sync`` Flag for sync-on-close. h](j )}(h ``h_sync``h]j)}(hj h]hh_sync}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(hFlag for sync-on-close.h]hFlag for sync-on-close.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h5``h_reserved`` Flag for handle for reserved credits. h](j )}(h``h_reserved``h]j)}(hj h]h h_reserved}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(h%Flag for handle for reserved credits.h]h%Flag for handle for reserved credits.}(hj& hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj" hMhj# ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj" hMhjubj)}(h5``h_aborted`` Flag indicating fatal error on handle. h](j )}(h ``h_aborted``h]j)}(hjF h]h h_aborted}(hjH hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjD ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj@ ubj#)}(hhh]h)}(h&Flag indicating fatal error on handle.h]h&Flag indicating fatal error on handle.}(hj_ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[ hMhj\ ubah}(h]h ]h"]h$]h&]uh1j"hj@ ubeh}(h]h ]h"]h$]h&]uh1jhj[ hMhjubj)}(h"``h_type`` For handle statistics. h](j )}(h ``h_type``h]j)}(hj h]hh_type}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj} ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjy ubj#)}(hhh]h)}(hFor handle statistics.h]hFor handle statistics.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hjy ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h%``h_line_no`` For handle statistics. h](j )}(h ``h_line_no``h]j)}(hj h]h h_line_no}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(hFor handle statistics.h]hFor handle statistics.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h'``h_start_jiffies`` Handle Start time. h](j )}(h``h_start_jiffies``h]j)}(hj h]hh_start_jiffies}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(hHandle Start time.h]hHandle Start time.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(hK``h_requested_credits`` Holds **h_total_credits** after handle is started. h](j )}(h``h_requested_credits``h]j)}(hj* h]hh_requested_credits}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj( ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj$ ubj#)}(hhh]h)}(h2Holds **h_total_credits** after handle is started.h](hHolds }(hjC hhhNhNubj=)}(h**h_total_credits**h]hh_total_credits}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjC ubh after handle is started.}(hjC hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj? hMhj@ ubah}(h]h ]h"]h$]h&]uh1j"hj$ ubeh}(h]h ]h"]h$]h&]uh1jhj? hMhjubj)}(h@``saved_alloc_context`` Saved context while transaction is open.h](j )}(h``saved_alloc_context``h]j)}(hju h]hsaved_alloc_context}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjo ubj#)}(hhh]h)}(h(Saved context while transaction is open.h]h(Saved context while transaction is open.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubah}(h]h ]h"]h$]h&]uh1j"hjo ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubeh}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjournal_s (C struct) c.journal_shNtauh1jhjhhhNhNubj)}(hhh](j)}(h journal_sh]j)}(hstruct journal_sh](j)}(hjVh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMubj)}(h journal_sh]j)}(hj h]h journal_s}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj hhhj hMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj hhhj hMubah}(h]j ah ](j j eh"]h$]h&]jj)jhuh1jhj hMhj hhubj)}(hhh]h)}(hBThe journal_s type is the concrete type associated with journal_t.h]hBThe journal_s type is the concrete type associated with journal_t.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj hMubeh}(h]h ](jmstructeh"]h$]h&]j2jmj3j) j4j) j5j6j7uh1jhhhjhNhNubj)}(hX-**Definition**:: struct journal_s { unsigned long j_flags; int j_errno; struct mutex j_abort_mutex; struct buffer_head *j_sb_buffer; journal_superblock_t *j_superblock; rwlock_t j_state_lock; int j_barrier_count; struct mutex j_barrier; transaction_t *j_running_transaction; transaction_t *j_committing_transaction; transaction_t *j_checkpoint_transactions; wait_queue_head_t j_wait_transaction_locked; wait_queue_head_t j_wait_done_commit; wait_queue_head_t j_wait_commit; wait_queue_head_t j_wait_updates; wait_queue_head_t j_wait_reserved; wait_queue_head_t j_fc_wait; struct mutex j_checkpoint_mutex; struct buffer_head *j_chkpt_bhs[JBD2_NR_BATCH]; struct shrinker *j_shrinker; struct percpu_counter j_checkpoint_jh_count; transaction_t *j_shrink_transaction; unsigned long j_head; unsigned long j_tail; unsigned long j_free; unsigned long j_first; unsigned long j_last; unsigned long j_fc_first; unsigned long j_fc_off; unsigned long j_fc_last; struct block_device *j_dev; int j_blocksize; unsigned long long j_blk_offset; char j_devname[BDEVNAME_SIZE+24]; struct block_device *j_fs_dev; errseq_t j_fs_dev_wb_err; unsigned int j_total_len; atomic_t j_reserved_credits; spinlock_t j_list_lock; struct inode *j_inode; tid_t j_tail_sequence; tid_t j_transaction_sequence; tid_t j_commit_sequence; tid_t j_commit_request; __u8 j_uuid[16]; struct task_struct *j_task; int j_max_transaction_buffers; int j_revoke_records_per_block; int j_transaction_overhead_buffers; unsigned long j_commit_interval; struct timer_list j_commit_timer; spinlock_t j_revoke_lock; struct jbd2_revoke_table_s *j_revoke; struct jbd2_revoke_table_s *j_revoke_table[2]; struct buffer_head **j_wbuf; struct buffer_head **j_fc_wbuf; int j_wbufsize; int j_fc_wbufsize; pid_t j_last_sync_writer; u64 j_average_commit_time; u32 j_min_batch_time; u32 j_max_batch_time; void (*j_commit_callback)(journal_t *, transaction_t *); int (*j_submit_inode_data_buffers) (struct jbd2_inode *); int (*j_finish_inode_data_buffers) (struct jbd2_inode *); spinlock_t j_history_lock; struct proc_dir_entry *j_proc_entry; struct transaction_stats_s j_stats; unsigned int j_failed_commit; void *j_private; __u32 j_csum_seed; #ifdef CONFIG_DEBUG_LOCK_ALLOC; struct lockdep_map j_trans_commit_map; #endif; struct lock_class_key jbd2_trans_commit_key; void (*j_fc_cleanup_callback)(struct journal_s *journal, int full, tid_t tid); int (*j_fc_replay_callback)(struct journal_s *journal, struct buffer_head *bh, enum passtype pass, int off, tid_t expected_commit_id); int (*j_bmap)(struct journal_s *journal, sector_t *block); }; **Members** ``j_flags`` General journaling state flags [j_state_lock, no lock for quick racy checks] ``j_errno`` Is there an outstanding uncleared error on the journal (from a prior abort)? [j_state_lock] ``j_abort_mutex`` Lock the whole aborting procedure. ``j_sb_buffer`` The first part of the superblock buffer. ``j_superblock`` The second part of the superblock buffer. ``j_state_lock`` Protect the various scalars in the journal. ``j_barrier_count`` Number of processes waiting to create a barrier lock [j_state_lock, no lock for quick racy checks] ``j_barrier`` The barrier lock itself. ``j_running_transaction`` Transactions: The current running transaction... [j_state_lock, no lock for quick racy checks] [caller holding open handle] ``j_committing_transaction`` the transaction we are pushing to disk [j_state_lock] [caller holding open handle] ``j_checkpoint_transactions`` ... and a linked circular list of all transactions waiting for checkpointing. [j_list_lock] ``j_wait_transaction_locked`` Wait queue for waiting for a locked transaction to start committing, or for a barrier lock to be released. ``j_wait_done_commit`` Wait queue for waiting for commit to complete. ``j_wait_commit`` Wait queue to trigger commit. ``j_wait_updates`` Wait queue to wait for updates to complete. ``j_wait_reserved`` Wait queue to wait for reserved buffer credits to drop. ``j_fc_wait`` Wait queue to wait for completion of async fast commits. ``j_checkpoint_mutex`` Semaphore for locking against concurrent checkpoints. ``j_chkpt_bhs`` List of buffer heads used by the checkpoint routine. This was moved from jbd2_log_do_checkpoint() to reduce stack usage. Access to this array is controlled by the **j_checkpoint_mutex**. [j_checkpoint_mutex] ``j_shrinker`` Journal head shrinker, reclaim buffer's journal head which has been written back. ``j_checkpoint_jh_count`` Number of journal buffers on the checkpoint list. [j_list_lock] ``j_shrink_transaction`` Record next transaction will shrink on the checkpoint list. [j_list_lock] ``j_head`` Journal head: identifies the first unused block in the journal. [j_state_lock] ``j_tail`` Journal tail: identifies the oldest still-used block in the journal. [j_state_lock] ``j_free`` Journal free: how many free blocks are there in the journal? [j_state_lock] ``j_first`` The block number of the first usable block in the journal [j_state_lock]. ``j_last`` The block number one beyond the last usable block in the journal [j_state_lock]. ``j_fc_first`` The block number of the first fast commit block in the journal [j_state_lock]. ``j_fc_off`` Number of fast commit blocks currently allocated. Accessed only during fast commit. Currently only process can do fast commit, so this field is not protected by any lock. ``j_fc_last`` The block number one beyond the last fast commit block in the journal [j_state_lock]. ``j_dev`` Device where we store the journal. ``j_blocksize`` Block size for the location where we store the journal. ``j_blk_offset`` Starting block offset into the device where we store the journal. ``j_devname`` Journal device name. ``j_fs_dev`` Device which holds the client fs. For internal journal this will be equal to j_dev. ``j_fs_dev_wb_err`` Records the errseq of the client fs's backing block device. ``j_total_len`` Total maximum capacity of the journal region on disk. ``j_reserved_credits`` Number of buffers reserved from the running transaction. ``j_list_lock`` Protects the buffer lists and internal buffer state. ``j_inode`` Optional inode where we store the journal. If present, all journal block numbers are mapped into this inode via bmap(). ``j_tail_sequence`` Sequence number of the oldest transaction in the log [j_state_lock] ``j_transaction_sequence`` Sequence number of the next transaction to grant [j_state_lock] ``j_commit_sequence`` Sequence number of the most recently committed transaction [j_state_lock, no lock for quick racy checks] ``j_commit_request`` Sequence number of the most recent transaction wanting commit [j_state_lock, no lock for quick racy checks] ``j_uuid`` Journal uuid: identifies the object (filesystem, LVM volume etc) backed by this journal. This will eventually be replaced by an array of uuids, allowing us to index multiple devices within a single journal and to perform atomic updates across them. ``j_task`` Pointer to the current commit thread for this journal. ``j_max_transaction_buffers`` Maximum number of metadata buffers to allow in a single compound commit transaction. ``j_revoke_records_per_block`` Number of revoke records that fit in one descriptor block. ``j_transaction_overhead_buffers`` Number of blocks each transaction needs for its own bookkeeping ``j_commit_interval`` What is the maximum transaction lifetime before we begin a commit? ``j_commit_timer`` The timer used to wakeup the commit thread. ``j_revoke_lock`` Protect the revoke table. ``j_revoke`` The revoke table - maintains the list of revoked blocks in the current transaction. ``j_revoke_table`` Alternate revoke tables for j_revoke. ``j_wbuf`` Array of bhs for jbd2_journal_commit_transaction. ``j_fc_wbuf`` Array of fast commit bhs for fast commit. Accessed only during a fast commit. Currently only process can do fast commit, so this field is not protected by any lock. ``j_wbufsize`` Size of **j_wbuf** array. ``j_fc_wbufsize`` Size of **j_fc_wbuf** array. ``j_last_sync_writer`` The pid of the last person to run a synchronous operation through the journal. ``j_average_commit_time`` The average amount of time in nanoseconds it takes to commit a transaction to disk. [j_state_lock] ``j_min_batch_time`` Minimum time that we should wait for additional filesystem operations to get batched into a synchronous handle in microseconds. ``j_max_batch_time`` Maximum time that we should wait for additional filesystem operations to get batched into a synchronous handle in microseconds. ``j_commit_callback`` This function is called when a transaction is closed. ``j_submit_inode_data_buffers`` This function is called for all inodes associated with the committing transaction marked with JI_WRITE_DATA flag before we start to write out the transaction to the journal. ``j_finish_inode_data_buffers`` This function is called for all inodes associated with the committing transaction marked with JI_WAIT_DATA flag after we have written the transaction to the journal but before we write out the commit block. ``j_history_lock`` Protect the transactions statistics history. ``j_proc_entry`` procfs entry for the jbd statistics directory. ``j_stats`` Overall statistics. ``j_failed_commit`` Failed journal commit ID. ``j_private`` An opaque pointer to fs-private information. ext3 puts its superblock pointer here. ``j_csum_seed`` Precomputed journal UUID checksum for seeding other checksums. ``j_trans_commit_map`` Lockdep entity to track transaction commit dependencies. Handles hold this "lock" for read, when we wait for commit, we acquire the "lock" for writing. This matches the properties of jbd2 journalling where the running transaction has to wait for all handles to be dropped to commit that transaction and also acquiring a handle may require transaction commit to finish. ``jbd2_trans_commit_key`` "struct lock_class_key" for **j_trans_commit_map** ``j_fc_cleanup_callback`` Clean-up after fast commit or full commit. JBD2 calls this function after every commit operation. ``j_fc_replay_callback`` File-system specific function that performs replay of a fast commit. JBD2 calls this function for each fast commit block found in the journal. This function should return JBD2_FC_REPLAY_CONTINUE to indicate that the block was processed correctly and more fast commit replay should continue. Return value of JBD2_FC_REPLAY_STOP indicates the end of replay (no more blocks remaining). A negative return value indicates error. ``j_bmap`` Bmap function that should be used instead of the generic VFS bmap function.h](h)}(h**Definition**::h](j=)}(h**Definition**h]h Definition}(hj5 hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj1 ubh:}(hj1 hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj- ubj)}(hX struct journal_s { unsigned long j_flags; int j_errno; struct mutex j_abort_mutex; struct buffer_head *j_sb_buffer; journal_superblock_t *j_superblock; rwlock_t j_state_lock; int j_barrier_count; struct mutex j_barrier; transaction_t *j_running_transaction; transaction_t *j_committing_transaction; transaction_t *j_checkpoint_transactions; wait_queue_head_t j_wait_transaction_locked; wait_queue_head_t j_wait_done_commit; wait_queue_head_t j_wait_commit; wait_queue_head_t j_wait_updates; wait_queue_head_t j_wait_reserved; wait_queue_head_t j_fc_wait; struct mutex j_checkpoint_mutex; struct buffer_head *j_chkpt_bhs[JBD2_NR_BATCH]; struct shrinker *j_shrinker; struct percpu_counter j_checkpoint_jh_count; transaction_t *j_shrink_transaction; unsigned long j_head; unsigned long j_tail; unsigned long j_free; unsigned long j_first; unsigned long j_last; unsigned long j_fc_first; unsigned long j_fc_off; unsigned long j_fc_last; struct block_device *j_dev; int j_blocksize; unsigned long long j_blk_offset; char j_devname[BDEVNAME_SIZE+24]; struct block_device *j_fs_dev; errseq_t j_fs_dev_wb_err; unsigned int j_total_len; atomic_t j_reserved_credits; spinlock_t j_list_lock; struct inode *j_inode; tid_t j_tail_sequence; tid_t j_transaction_sequence; tid_t j_commit_sequence; tid_t j_commit_request; __u8 j_uuid[16]; struct task_struct *j_task; int j_max_transaction_buffers; int j_revoke_records_per_block; int j_transaction_overhead_buffers; unsigned long j_commit_interval; struct timer_list j_commit_timer; spinlock_t j_revoke_lock; struct jbd2_revoke_table_s *j_revoke; struct jbd2_revoke_table_s *j_revoke_table[2]; struct buffer_head **j_wbuf; struct buffer_head **j_fc_wbuf; int j_wbufsize; int j_fc_wbufsize; pid_t j_last_sync_writer; u64 j_average_commit_time; u32 j_min_batch_time; u32 j_max_batch_time; void (*j_commit_callback)(journal_t *, transaction_t *); int (*j_submit_inode_data_buffers) (struct jbd2_inode *); int (*j_finish_inode_data_buffers) (struct jbd2_inode *); spinlock_t j_history_lock; struct proc_dir_entry *j_proc_entry; struct transaction_stats_s j_stats; unsigned int j_failed_commit; void *j_private; __u32 j_csum_seed; #ifdef CONFIG_DEBUG_LOCK_ALLOC; struct lockdep_map j_trans_commit_map; #endif; struct lock_class_key jbd2_trans_commit_key; void (*j_fc_cleanup_callback)(struct journal_s *journal, int full, tid_t tid); int (*j_fc_replay_callback)(struct journal_s *journal, struct buffer_head *bh, enum passtype pass, int off, tid_t expected_commit_id); int (*j_bmap)(struct journal_s *journal, sector_t *block); };h]hX struct journal_s { unsigned long j_flags; int j_errno; struct mutex j_abort_mutex; struct buffer_head *j_sb_buffer; journal_superblock_t *j_superblock; rwlock_t j_state_lock; int j_barrier_count; struct mutex j_barrier; transaction_t *j_running_transaction; transaction_t *j_committing_transaction; transaction_t *j_checkpoint_transactions; wait_queue_head_t j_wait_transaction_locked; wait_queue_head_t j_wait_done_commit; wait_queue_head_t j_wait_commit; wait_queue_head_t j_wait_updates; wait_queue_head_t j_wait_reserved; wait_queue_head_t j_fc_wait; struct mutex j_checkpoint_mutex; struct buffer_head *j_chkpt_bhs[JBD2_NR_BATCH]; struct shrinker *j_shrinker; struct percpu_counter j_checkpoint_jh_count; transaction_t *j_shrink_transaction; unsigned long j_head; unsigned long j_tail; unsigned long j_free; unsigned long j_first; unsigned long j_last; unsigned long j_fc_first; unsigned long j_fc_off; unsigned long j_fc_last; struct block_device *j_dev; int j_blocksize; unsigned long long j_blk_offset; char j_devname[BDEVNAME_SIZE+24]; struct block_device *j_fs_dev; errseq_t j_fs_dev_wb_err; unsigned int j_total_len; atomic_t j_reserved_credits; spinlock_t j_list_lock; struct inode *j_inode; tid_t j_tail_sequence; tid_t j_transaction_sequence; tid_t j_commit_sequence; tid_t j_commit_request; __u8 j_uuid[16]; struct task_struct *j_task; int j_max_transaction_buffers; int j_revoke_records_per_block; int j_transaction_overhead_buffers; unsigned long j_commit_interval; struct timer_list j_commit_timer; spinlock_t j_revoke_lock; struct jbd2_revoke_table_s *j_revoke; struct jbd2_revoke_table_s *j_revoke_table[2]; struct buffer_head **j_wbuf; struct buffer_head **j_fc_wbuf; int j_wbufsize; int j_fc_wbufsize; pid_t j_last_sync_writer; u64 j_average_commit_time; u32 j_min_batch_time; u32 j_max_batch_time; void (*j_commit_callback)(journal_t *, transaction_t *); int (*j_submit_inode_data_buffers) (struct jbd2_inode *); int (*j_finish_inode_data_buffers) (struct jbd2_inode *); spinlock_t j_history_lock; struct proc_dir_entry *j_proc_entry; struct transaction_stats_s j_stats; unsigned int j_failed_commit; void *j_private; __u32 j_csum_seed; #ifdef CONFIG_DEBUG_LOCK_ALLOC; struct lockdep_map j_trans_commit_map; #endif; struct lock_class_key jbd2_trans_commit_key; void (*j_fc_cleanup_callback)(struct journal_s *journal, int full, tid_t tid); int (*j_fc_replay_callback)(struct journal_s *journal, struct buffer_head *bh, enum passtype pass, int off, tid_t expected_commit_id); int (*j_bmap)(struct journal_s *journal, sector_t *block); };}hjN sbah}(h]h ]h"]h$]h&]jjuh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj- ubh)}(h **Members**h]j=)}(hj_ h]hMembers}(hja hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj] ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMPhj- ubj)}(hhh](j)}(hY``j_flags`` General journaling state flags [j_state_lock, no lock for quick racy checks] h](j )}(h ``j_flags``h]j)}(hj~ h]hj_flags}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj| ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjx ubj#)}(hhh]h)}(hLGeneral journaling state flags [j_state_lock, no lock for quick racy checks]h]hLGeneral journaling state flags [j_state_lock, no lock for quick racy checks]}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubah}(h]h ]h"]h$]h&]uh1j"hjx ubeh}(h]h ]h"]h$]h&]uh1jhj hMhju ubj)}(hh``j_errno`` Is there an outstanding uncleared error on the journal (from a prior abort)? [j_state_lock] h](j )}(h ``j_errno``h]j)}(hj h]hj_errno}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(h[Is there an outstanding uncleared error on the journal (from a prior abort)? [j_state_lock]h]h[Is there an outstanding uncleared error on the journal (from a prior abort)? [j_state_lock]}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhju ubj)}(h5``j_abort_mutex`` Lock the whole aborting procedure. h](j )}(h``j_abort_mutex``h]j)}(hj h]h j_abort_mutex}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(h"Lock the whole aborting procedure.h]h"Lock the whole aborting procedure.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h9``j_sb_buffer`` The first part of the superblock buffer. h](j )}(h``j_sb_buffer``h]j)}(hj+h]h j_sb_buffer}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj%ubj#)}(hhh]h)}(h(The first part of the superblock buffer.h]h(The first part of the superblock buffer.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@hMhjAubah}(h]h ]h"]h$]h&]uh1j"hj%ubeh}(h]h ]h"]h$]h&]uh1jhj@hMhju ubj)}(h;``j_superblock`` The second part of the superblock buffer. h](j )}(h``j_superblock``h]j)}(hjdh]h j_superblock}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj^ubj#)}(hhh]h)}(h)The second part of the superblock buffer.h]h)The second part of the superblock buffer.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyhMhjzubah}(h]h ]h"]h$]h&]uh1j"hj^ubeh}(h]h ]h"]h$]h&]uh1jhjyhMhju ubj)}(h=``j_state_lock`` Protect the various scalars in the journal. h](j )}(h``j_state_lock``h]j)}(hjh]h j_state_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h+Protect the various scalars in the journal.h]h+Protect the various scalars in the journal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hw``j_barrier_count`` Number of processes waiting to create a barrier lock [j_state_lock, no lock for quick racy checks] h](j )}(h``j_barrier_count``h]j)}(hjh]hj_barrier_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM#hjubj#)}(hhh]h)}(hbNumber of processes waiting to create a barrier lock [j_state_lock, no lock for quick racy checks]h]hbNumber of processes waiting to create a barrier lock [j_state_lock, no lock for quick racy checks]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM"hjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhM#hju ubj)}(h'``j_barrier`` The barrier lock itself. h](j )}(h ``j_barrier``h]j)}(hjh]h j_barrier}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM*hj ubj#)}(hhh]h)}(hThe barrier lock itself.h]hThe barrier lock itself.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hM*hj&ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj%hM*hju ubj)}(h``j_running_transaction`` Transactions: The current running transaction... [j_state_lock, no lock for quick racy checks] [caller holding open handle] h](j )}(h``j_running_transaction``h]j)}(hjIh]hj_running_transaction}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM1hjCubj#)}(hhh]h)}(h{Transactions: The current running transaction... [j_state_lock, no lock for quick racy checks] [caller holding open handle]h]h{Transactions: The current running transaction... [j_state_lock, no lock for quick racy checks] [caller holding open handle]}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM/hj_ubah}(h]h ]h"]h$]h&]uh1j"hjCubeh}(h]h ]h"]h$]h&]uh1jhj^hM1hju ubj)}(hp``j_committing_transaction`` the transaction we are pushing to disk [j_state_lock] [caller holding open handle] h](j )}(h``j_committing_transaction``h]j)}(hjh]hj_committing_transaction}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM9hj}ubj#)}(hhh]h)}(hRthe transaction we are pushing to disk [j_state_lock] [caller holding open handle]h]hRthe transaction we are pushing to disk [j_state_lock] [caller holding open handle]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM8hjubah}(h]h ]h"]h$]h&]uh1j"hj}ubeh}(h]h ]h"]h$]h&]uh1jhjhM9hju ubj)}(hz``j_checkpoint_transactions`` ... and a linked circular list of all transactions waiting for checkpointing. [j_list_lock] h](j )}(h``j_checkpoint_transactions``h]j)}(hjh]hj_checkpoint_transactions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMAhjubj#)}(hhh]h)}(h[... and a linked circular list of all transactions waiting for checkpointing. [j_list_lock]h]h[... and a linked circular list of all transactions waiting for checkpointing. [j_list_lock]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM@hjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMAhju ubj)}(h``j_wait_transaction_locked`` Wait queue for waiting for a locked transaction to start committing, or for a barrier lock to be released. h](j )}(h``j_wait_transaction_locked``h]j)}(hjh]hj_wait_transaction_locked}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMIhjubj#)}(hhh]h)}(hjWait queue for waiting for a locked transaction to start committing, or for a barrier lock to be released.h]hjWait queue for waiting for a locked transaction to start committing, or for a barrier lock to be released.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMHhj ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj hMIhju ubj)}(hF``j_wait_done_commit`` Wait queue for waiting for commit to complete. h](j )}(h``j_wait_done_commit``h]j)}(hj1h]hj_wait_done_commit}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMPhj+ubj#)}(hhh]h)}(h.Wait queue for waiting for commit to complete.h]h.Wait queue for waiting for commit to complete.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhMPhjGubah}(h]h ]h"]h$]h&]uh1j"hj+ubeh}(h]h ]h"]h$]h&]uh1jhjFhMPhju ubj)}(h0``j_wait_commit`` Wait queue to trigger commit. h](j )}(h``j_wait_commit``h]j)}(hjjh]h j_wait_commit}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMUhjdubj#)}(hhh]h)}(hWait queue to trigger commit.h]hWait queue to trigger commit.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMUhjubah}(h]h ]h"]h$]h&]uh1j"hjdubeh}(h]h ]h"]h$]h&]uh1jhjhMUhju ubj)}(h?``j_wait_updates`` Wait queue to wait for updates to complete. h](j )}(h``j_wait_updates``h]j)}(hjh]hj_wait_updates}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMZhjubj#)}(hhh]h)}(h+Wait queue to wait for updates to complete.h]h+Wait queue to wait for updates to complete.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMZhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMZhju ubj)}(hL``j_wait_reserved`` Wait queue to wait for reserved buffer credits to drop. h](j )}(h``j_wait_reserved``h]j)}(hjh]hj_wait_reserved}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM_hjubj#)}(hhh]h)}(h7Wait queue to wait for reserved buffer credits to drop.h]h7Wait queue to wait for reserved buffer credits to drop.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM_hjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhM_hju ubj)}(hG``j_fc_wait`` Wait queue to wait for completion of async fast commits. h](j )}(h ``j_fc_wait``h]j)}(hjh]h j_fc_wait}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMfhjubj#)}(hhh]h)}(h8Wait queue to wait for completion of async fast commits.h]h8Wait queue to wait for completion of async fast commits.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMfhj+ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj*hMfhju ubj)}(hM``j_checkpoint_mutex`` Semaphore for locking against concurrent checkpoints. h](j )}(h``j_checkpoint_mutex``h]j)}(hjNh]hj_checkpoint_mutex}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMmhjHubj#)}(hhh]h)}(h5Semaphore for locking against concurrent checkpoints.h]h5Semaphore for locking against concurrent checkpoints.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchMmhjdubah}(h]h ]h"]h$]h&]uh1j"hjHubeh}(h]h ]h"]h$]h&]uh1jhjchMmhju ubj)}(h``j_chkpt_bhs`` List of buffer heads used by the checkpoint routine. This was moved from jbd2_log_do_checkpoint() to reduce stack usage. Access to this array is controlled by the **j_checkpoint_mutex**. [j_checkpoint_mutex] h](j )}(h``j_chkpt_bhs``h]j)}(hjh]h j_chkpt_bhs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMwhjubj#)}(hhh]h)}(hList of buffer heads used by the checkpoint routine. This was moved from jbd2_log_do_checkpoint() to reduce stack usage. Access to this array is controlled by the **j_checkpoint_mutex**. [j_checkpoint_mutex]h](hList of buffer heads used by the checkpoint routine. This was moved from jbd2_log_do_checkpoint() to reduce stack usage. Access to this array is controlled by the }(hjhhhNhNubj=)}(h**j_checkpoint_mutex**h]hj_checkpoint_mutex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjubh. [j_checkpoint_mutex]}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMthjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMwhju ubj)}(ha``j_shrinker`` Journal head shrinker, reclaim buffer's journal head which has been written back. h](j )}(h``j_shrinker``h]j)}(hjh]h j_shrinker}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hQJournal head shrinker, reclaim buffer's journal head which has been written back.h]hSJournal head shrinker, reclaim buffer’s journal head which has been written back.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM~hjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hZ``j_checkpoint_jh_count`` Number of journal buffers on the checkpoint list. [j_list_lock] h](j )}(h``j_checkpoint_jh_count``h]j)}(hj h]hj_checkpoint_jh_count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h?Number of journal buffers on the checkpoint list. [j_list_lock]h]h?Number of journal buffers on the checkpoint list. [j_list_lock]}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hMhj#ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj"hMhju ubj)}(hc``j_shrink_transaction`` Record next transaction will shrink on the checkpoint list. [j_list_lock] h](j )}(h``j_shrink_transaction``h]j)}(hjFh]hj_shrink_transaction}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj@ubj#)}(hhh]h)}(hIRecord next transaction will shrink on the checkpoint list. [j_list_lock]h]hIRecord next transaction will shrink on the checkpoint list. [j_list_lock]}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj\ubah}(h]h ]h"]h$]h&]uh1j"hj@ubeh}(h]h ]h"]h$]h&]uh1jhj[hMhju ubj)}(hZ``j_head`` Journal head: identifies the first unused block in the journal. [j_state_lock] h](j )}(h ``j_head``h]j)}(hjh]hj_head}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjzubj#)}(hhh]h)}(hNJournal head: identifies the first unused block in the journal. [j_state_lock]h]hNJournal head: identifies the first unused block in the journal. [j_state_lock]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjzubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h_``j_tail`` Journal tail: identifies the oldest still-used block in the journal. [j_state_lock] h](j )}(h ``j_tail``h]j)}(hjh]hj_tail}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hSJournal tail: identifies the oldest still-used block in the journal. [j_state_lock]h]hSJournal tail: identifies the oldest still-used block in the journal. [j_state_lock]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hW``j_free`` Journal free: how many free blocks are there in the journal? [j_state_lock] h](j )}(h ``j_free``h]j)}(hjh]hj_free}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hKJournal free: how many free blocks are there in the journal? [j_state_lock]h]hKJournal free: how many free blocks are there in the journal? [j_state_lock]}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj hMhju ubj)}(hV``j_first`` The block number of the first usable block in the journal [j_state_lock]. h](j )}(h ``j_first``h]j)}(hj.h]hj_first}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj(ubj#)}(hhh]h)}(hIThe block number of the first usable block in the journal [j_state_lock].h]hIThe block number of the first usable block in the journal [j_state_lock].}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjDubah}(h]h ]h"]h$]h&]uh1j"hj(ubeh}(h]h ]h"]h$]h&]uh1jhjChMhju ubj)}(h\``j_last`` The block number one beyond the last usable block in the journal [j_state_lock]. h](j )}(h ``j_last``h]j)}(hjhh]hj_last}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjbubj#)}(hhh]h)}(hPThe block number one beyond the last usable block in the journal [j_state_lock].h]hPThe block number one beyond the last usable block in the journal [j_state_lock].}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj~ubah}(h]h ]h"]h$]h&]uh1j"hjbubeh}(h]h ]h"]h$]h&]uh1jhj}hMhju ubj)}(h^``j_fc_first`` The block number of the first fast commit block in the journal [j_state_lock]. h](j )}(h``j_fc_first``h]j)}(hjh]h j_fc_first}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hNThe block number of the first fast commit block in the journal [j_state_lock].h]hNThe block number of the first fast commit block in the journal [j_state_lock].}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h``j_fc_off`` Number of fast commit blocks currently allocated. Accessed only during fast commit. Currently only process can do fast commit, so this field is not protected by any lock. h](j )}(h ``j_fc_off``h]j)}(hjh]hj_fc_off}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hNumber of fast commit blocks currently allocated. Accessed only during fast commit. Currently only process can do fast commit, so this field is not protected by any lock.h]hNumber of fast commit blocks currently allocated. Accessed only during fast commit. Currently only process can do fast commit, so this field is not protected by any lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hd``j_fc_last`` The block number one beyond the last fast commit block in the journal [j_state_lock]. h](j )}(h ``j_fc_last``h]j)}(hjh]h j_fc_last}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hUThe block number one beyond the last fast commit block in the journal [j_state_lock].h]hUThe block number one beyond the last fast commit block in the journal [j_state_lock].}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj,ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj+hMhju ubj)}(h-``j_dev`` Device where we store the journal. h](j )}(h ``j_dev``h]j)}(hjPh]hj_dev}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjJubj#)}(hhh]h)}(h"Device where we store the journal.h]h"Device where we store the journal.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehMhjfubah}(h]h ]h"]h$]h&]uh1j"hjJubeh}(h]h ]h"]h$]h&]uh1jhjehMhju ubj)}(hH``j_blocksize`` Block size for the location where we store the journal. h](j )}(h``j_blocksize``h]j)}(hjh]h j_blocksize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h7Block size for the location where we store the journal.h]h7Block size for the location where we store the journal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hS``j_blk_offset`` Starting block offset into the device where we store the journal. h](j )}(h``j_blk_offset``h]j)}(hjh]h j_blk_offset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hAStarting block offset into the device where we store the journal.h]hAStarting block offset into the device where we store the journal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h#``j_devname`` Journal device name. h](j )}(h ``j_devname``h]j)}(hjh]h j_devname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hJournal device name.h]hJournal device name.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hb``j_fs_dev`` Device which holds the client fs. For internal journal this will be equal to j_dev. h](j )}(h ``j_fs_dev``h]j)}(hj4h]hj_fs_dev}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj.ubj#)}(hhh]h)}(hTDevice which holds the client fs. For internal journal this will be equal to j_dev.h]hTDevice which holds the client fs. For internal journal this will be equal to j_dev.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjJubah}(h]h ]h"]h$]h&]uh1j"hj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhMhju ubj)}(hP``j_fs_dev_wb_err`` Records the errseq of the client fs's backing block device. h](j )}(h``j_fs_dev_wb_err``h]j)}(hjnh]hj_fs_dev_wb_err}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjhubj#)}(hhh]h)}(h;Records the errseq of the client fs's backing block device.h]h=Records the errseq of the client fs’s backing block device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjhubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hF``j_total_len`` Total maximum capacity of the journal region on disk. h](j )}(h``j_total_len``h]j)}(hjh]h j_total_len}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h5Total maximum capacity of the journal region on disk.h]h5Total maximum capacity of the journal region on disk.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hP``j_reserved_credits`` Number of buffers reserved from the running transaction. h](j )}(h``j_reserved_credits``h]j)}(hjh]hj_reserved_credits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h8Number of buffers reserved from the running transaction.h]h8Number of buffers reserved from the running transaction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hE``j_list_lock`` Protects the buffer lists and internal buffer state. h](j )}(h``j_list_lock``h]j)}(hjh]h j_list_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h4Protects the buffer lists and internal buffer state.h]h4Protects the buffer lists and internal buffer state.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMhj/ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj.hMhju ubj)}(h``j_inode`` Optional inode where we store the journal. If present, all journal block numbers are mapped into this inode via bmap(). h](j )}(h ``j_inode``h]j)}(hjRh]hj_inode}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM hjLubj#)}(hhh]h)}(hxOptional inode where we store the journal. If present, all journal block numbers are mapped into this inode via bmap().h]hxOptional inode where we store the journal. If present, all journal block numbers are mapped into this inode via bmap().}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM hjhubah}(h]h ]h"]h$]h&]uh1j"hjLubeh}(h]h ]h"]h$]h&]uh1jhjghM hju ubj)}(hX``j_tail_sequence`` Sequence number of the oldest transaction in the log [j_state_lock] h](j )}(h``j_tail_sequence``h]j)}(hjh]hj_tail_sequence}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hCSequence number of the oldest transaction in the log [j_state_lock]h]hCSequence number of the oldest transaction in the log [j_state_lock]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h[``j_transaction_sequence`` Sequence number of the next transaction to grant [j_state_lock] h](j )}(h``j_transaction_sequence``h]j)}(hjh]hj_transaction_sequence}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h?Sequence number of the next transaction to grant [j_state_lock]h]h?Sequence number of the next transaction to grant [j_state_lock]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h``j_commit_sequence`` Sequence number of the most recently committed transaction [j_state_lock, no lock for quick racy checks] h](j )}(h``j_commit_sequence``h]j)}(hjh]hj_commit_sequence}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM#hjubj#)}(hhh]h)}(hhSequence number of the most recently committed transaction [j_state_lock, no lock for quick racy checks]h]hhSequence number of the most recently committed transaction [j_state_lock, no lock for quick racy checks]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM"hjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhM#hju ubj)}(h``j_commit_request`` Sequence number of the most recent transaction wanting commit [j_state_lock, no lock for quick racy checks] h](j )}(h``j_commit_request``h]j)}(hj8h]hj_commit_request}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM+hj2ubj#)}(hhh]h)}(hkSequence number of the most recent transaction wanting commit [j_state_lock, no lock for quick racy checks]h]hkSequence number of the most recent transaction wanting commit [j_state_lock, no lock for quick racy checks]}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM*hjNubah}(h]h ]h"]h$]h&]uh1j"hj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhM+hju ubj)}(hX``j_uuid`` Journal uuid: identifies the object (filesystem, LVM volume etc) backed by this journal. This will eventually be replaced by an array of uuids, allowing us to index multiple devices within a single journal and to perform atomic updates across them. h](j )}(h ``j_uuid``h]j)}(hjrh]hj_uuid}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM5hjlubj#)}(hhh]h)}(hJournal uuid: identifies the object (filesystem, LVM volume etc) backed by this journal. This will eventually be replaced by an array of uuids, allowing us to index multiple devices within a single journal and to perform atomic updates across them.h]hJournal uuid: identifies the object (filesystem, LVM volume etc) backed by this journal. This will eventually be replaced by an array of uuids, allowing us to index multiple devices within a single journal and to perform atomic updates across them.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM2hjubah}(h]h ]h"]h$]h&]uh1j"hjlubeh}(h]h ]h"]h$]h&]uh1jhjhM5hju ubj)}(hB``j_task`` Pointer to the current commit thread for this journal. h](j )}(h ``j_task``h]j)}(hjh]hj_task}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM<hjubj#)}(hhh]h)}(h6Pointer to the current commit thread for this journal.h]h6Pointer to the current commit thread for this journal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM<hjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhM<hju ubj)}(hs``j_max_transaction_buffers`` Maximum number of metadata buffers to allow in a single compound commit transaction. h](j )}(h``j_max_transaction_buffers``h]j)}(hjh]hj_max_transaction_buffers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMBhjubj#)}(hhh]h)}(hTMaximum number of metadata buffers to allow in a single compound commit transaction.h]hTMaximum number of metadata buffers to allow in a single compound commit transaction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMAhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMBhju ubj)}(hZ``j_revoke_records_per_block`` Number of revoke records that fit in one descriptor block. h](j )}(h``j_revoke_records_per_block``h]j)}(hjh]hj_revoke_records_per_block}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMIhjubj#)}(hhh]h)}(h:Number of revoke records that fit in one descriptor block.h]h:Number of revoke records that fit in one descriptor block.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMIhj5ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj4hMIhju ubj)}(hc``j_transaction_overhead_buffers`` Number of blocks each transaction needs for its own bookkeeping h](j )}(h"``j_transaction_overhead_buffers``h]j)}(hjXh]hj_transaction_overhead_buffers}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMPhjRubj#)}(hhh]h)}(h?Number of blocks each transaction needs for its own bookkeepingh]h?Number of blocks each transaction needs for its own bookkeeping}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhMPhjnubah}(h]h ]h"]h$]h&]uh1j"hjRubeh}(h]h ]h"]h$]h&]uh1jhjmhMPhju ubj)}(hY``j_commit_interval`` What is the maximum transaction lifetime before we begin a commit? h](j )}(h``j_commit_interval``h]j)}(hjh]hj_commit_interval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMWhjubj#)}(hhh]h)}(hBWhat is the maximum transaction lifetime before we begin a commit?h]hBWhat is the maximum transaction lifetime before we begin a commit?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMWhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMWhju ubj)}(h?``j_commit_timer`` The timer used to wakeup the commit thread. h](j )}(h``j_commit_timer``h]j)}(hjh]hj_commit_timer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM^hjubj#)}(hhh]h)}(h+The timer used to wakeup the commit thread.h]h+The timer used to wakeup the commit thread.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM^hjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhM^hju ubj)}(h,``j_revoke_lock`` Protect the revoke table. h](j )}(h``j_revoke_lock``h]j)}(hjh]h j_revoke_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMchjubj#)}(hhh]h)}(hProtect the revoke table.h]hProtect the revoke table.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMchjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMchju ubj)}(ha``j_revoke`` The revoke table - maintains the list of revoked blocks in the current transaction. h](j )}(h ``j_revoke``h]j)}(hj<h]hj_revoke}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMihj6ubj#)}(hhh]h)}(hSThe revoke table - maintains the list of revoked blocks in the current transaction.h]hSThe revoke table - maintains the list of revoked blocks in the current transaction.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhhjRubah}(h]h ]h"]h$]h&]uh1j"hj6ubeh}(h]h ]h"]h$]h&]uh1jhjQhMihju ubj)}(h9``j_revoke_table`` Alternate revoke tables for j_revoke. h](j )}(h``j_revoke_table``h]j)}(hjvh]hj_revoke_table}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMphjpubj#)}(hhh]h)}(h%Alternate revoke tables for j_revoke.h]h%Alternate revoke tables for j_revoke.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMphjubah}(h]h ]h"]h$]h&]uh1j"hjpubeh}(h]h ]h"]h$]h&]uh1jhjhMphju ubj)}(h=``j_wbuf`` Array of bhs for jbd2_journal_commit_transaction. h](j )}(h ``j_wbuf``h]j)}(hjh]hj_wbuf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMuhjubj#)}(hhh]h)}(h1Array of bhs for jbd2_journal_commit_transaction.h]h1Array of bhs for jbd2_journal_commit_transaction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMuhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMuhju ubj)}(h``j_fc_wbuf`` Array of fast commit bhs for fast commit. Accessed only during a fast commit. Currently only process can do fast commit, so this field is not protected by any lock. h](j )}(h ``j_fc_wbuf``h]j)}(hjh]h j_fc_wbuf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhM|hjubj#)}(hhh]h)}(hArray of fast commit bhs for fast commit. Accessed only during a fast commit. Currently only process can do fast commit, so this field is not protected by any lock.h]hArray of fast commit bhs for fast commit. Accessed only during a fast commit. Currently only process can do fast commit, so this field is not protected by any lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMzhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhM|hju ubj)}(h)``j_wbufsize`` Size of **j_wbuf** array. h](j )}(h``j_wbufsize``h]j)}(hj"h]h j_wbufsize}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hSize of **j_wbuf** array.h](hSize of }(hj;hhhNhNubj=)}(h **j_wbuf**h]hj_wbuf}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj;ubh array.}(hj;hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj7hMhj8ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj7hMhju ubj)}(h/``j_fc_wbufsize`` Size of **j_fc_wbuf** array. h](j )}(h``j_fc_wbufsize``h]j)}(hjmh]h j_fc_wbufsize}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjgubj#)}(hhh]h)}(hSize of **j_fc_wbuf** array.h](hSize of }(hjhhhNhNubj=)}(h **j_fc_wbuf**h]h j_fc_wbuf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjubh array.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjgubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hf``j_last_sync_writer`` The pid of the last person to run a synchronous operation through the journal. h](j )}(h``j_last_sync_writer``h]j)}(hjh]hj_last_sync_writer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hNThe pid of the last person to run a synchronous operation through the journal.h]hNThe pid of the last person to run a synchronous operation through the journal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h}``j_average_commit_time`` The average amount of time in nanoseconds it takes to commit a transaction to disk. [j_state_lock] h](j )}(h``j_average_commit_time``h]j)}(hjh]hj_average_commit_time}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hbThe average amount of time in nanoseconds it takes to commit a transaction to disk. [j_state_lock]h]hbThe average amount of time in nanoseconds it takes to commit a transaction to disk. [j_state_lock]}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h``j_min_batch_time`` Minimum time that we should wait for additional filesystem operations to get batched into a synchronous handle in microseconds. h](j )}(h``j_min_batch_time``h]j)}(hj,h]hj_min_batch_time}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj&ubj#)}(hhh]h)}(hMinimum time that we should wait for additional filesystem operations to get batched into a synchronous handle in microseconds.h]hMinimum time that we should wait for additional filesystem operations to get batched into a synchronous handle in microseconds.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjBubah}(h]h ]h"]h$]h&]uh1j"hj&ubeh}(h]h ]h"]h$]h&]uh1jhjAhMhju ubj)}(h``j_max_batch_time`` Maximum time that we should wait for additional filesystem operations to get batched into a synchronous handle in microseconds. h](j )}(h``j_max_batch_time``h]j)}(hjfh]hj_max_batch_time}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj`ubj#)}(hhh]h)}(hMaximum time that we should wait for additional filesystem operations to get batched into a synchronous handle in microseconds.h]hMaximum time that we should wait for additional filesystem operations to get batched into a synchronous handle in microseconds.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj|ubah}(h]h ]h"]h$]h&]uh1j"hj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hMhju ubj)}(hL``j_commit_callback`` This function is called when a transaction is closed. h](j )}(h``j_commit_callback``h]j)}(hjh]hj_commit_callback}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h5This function is called when a transaction is closed.h]h5This function is called when a transaction is closed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h``j_submit_inode_data_buffers`` This function is called for all inodes associated with the committing transaction marked with JI_WRITE_DATA flag before we start to write out the transaction to the journal. h](j )}(h``j_submit_inode_data_buffers``h]j)}(hjh]hj_submit_inode_data_buffers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hThis function is called for all inodes associated with the committing transaction marked with JI_WRITE_DATA flag before we start to write out the transaction to the journal.h]hThis function is called for all inodes associated with the committing transaction marked with JI_WRITE_DATA flag before we start to write out the transaction to the journal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h``j_finish_inode_data_buffers`` This function is called for all inodes associated with the committing transaction marked with JI_WAIT_DATA flag after we have written the transaction to the journal but before we write out the commit block. h](j )}(h``j_finish_inode_data_buffers``h]j)}(hjh]hj_finish_inode_data_buffers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj ubj#)}(hhh]h)}(hThis function is called for all inodes associated with the committing transaction marked with JI_WAIT_DATA flag after we have written the transaction to the journal but before we write out the commit block.h]hThis function is called for all inodes associated with the committing transaction marked with JI_WAIT_DATA flag after we have written the transaction to the journal but before we write out the commit block.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj)ubah}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhju ubj)}(h@``j_history_lock`` Protect the transactions statistics history. h](j )}(h``j_history_lock``h]j)}(hjMh]hj_history_lock}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjGubj#)}(hhh]h)}(h,Protect the transactions statistics history.h]h,Protect the transactions statistics history.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjcubah}(h]h ]h"]h$]h&]uh1j"hjGubeh}(h]h ]h"]h$]h&]uh1jhjbhMhju ubj)}(h@``j_proc_entry`` procfs entry for the jbd statistics directory. h](j )}(h``j_proc_entry``h]j)}(hjh]h j_proc_entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h.procfs entry for the jbd statistics directory.h]h.procfs entry for the jbd statistics directory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h ``j_stats`` Overall statistics. h](j )}(h ``j_stats``h]j)}(hjh]hj_stats}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hOverall statistics.h]hOverall statistics.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h.``j_failed_commit`` Failed journal commit ID. h](j )}(h``j_failed_commit``h]j)}(hjh]hj_failed_commit}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hFailed journal commit ID.h]hFailed journal commit ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj hMhju ubj)}(hc``j_private`` An opaque pointer to fs-private information. ext3 puts its superblock pointer here. h](j )}(h ``j_private``h]j)}(hj1h]h j_private}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj+ubj#)}(hhh]h)}(hTAn opaque pointer to fs-private information. ext3 puts its superblock pointer here.h]hTAn opaque pointer to fs-private information. ext3 puts its superblock pointer here.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjGubah}(h]h ]h"]h$]h&]uh1j"hj+ubeh}(h]h ]h"]h$]h&]uh1jhjFhMhju ubj)}(hO``j_csum_seed`` Precomputed journal UUID checksum for seeding other checksums. h](j )}(h``j_csum_seed``h]j)}(hjkh]h j_csum_seed}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjiubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjeubj#)}(hhh]h)}(h>Precomputed journal UUID checksum for seeding other checksums.h]h>Precomputed journal UUID checksum for seeding other checksums.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjeubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hX``j_trans_commit_map`` Lockdep entity to track transaction commit dependencies. Handles hold this "lock" for read, when we wait for commit, we acquire the "lock" for writing. This matches the properties of jbd2 journalling where the running transaction has to wait for all handles to be dropped to commit that transaction and also acquiring a handle may require transaction commit to finish. h](j )}(h``j_trans_commit_map``h]j)}(hjh]hj_trans_commit_map}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hXpLockdep entity to track transaction commit dependencies. Handles hold this "lock" for read, when we wait for commit, we acquire the "lock" for writing. This matches the properties of jbd2 journalling where the running transaction has to wait for all handles to be dropped to commit that transaction and also acquiring a handle may require transaction commit to finish.h]hXxLockdep entity to track transaction commit dependencies. Handles hold this “lock” for read, when we wait for commit, we acquire the “lock” for writing. This matches the properties of jbd2 journalling where the running transaction has to wait for all handles to be dropped to commit that transaction and also acquiring a handle may require transaction commit to finish.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(hM``jbd2_trans_commit_key`` "struct lock_class_key" for **j_trans_commit_map** h](j )}(h``jbd2_trans_commit_key``h]j)}(hjh]hjbd2_trans_commit_key}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(h2"struct lock_class_key" for **j_trans_commit_map**h](h “struct lock_class_key” for }(hjhhhNhNubj=)}(h**j_trans_commit_map**h]hj_trans_commit_map}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubj)}(h|``j_fc_cleanup_callback`` Clean-up after fast commit or full commit. JBD2 calls this function after every commit operation. h](j )}(h``j_fc_cleanup_callback``h]j)}(hj%h]hj_fc_cleanup_callback}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(haClean-up after fast commit or full commit. JBD2 calls this function after every commit operation.h]haClean-up after fast commit or full commit. JBD2 calls this function after every commit operation.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhj;ubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhj:hMhju ubj)}(hX``j_fc_replay_callback`` File-system specific function that performs replay of a fast commit. JBD2 calls this function for each fast commit block found in the journal. This function should return JBD2_FC_REPLAY_CONTINUE to indicate that the block was processed correctly and more fast commit replay should continue. Return value of JBD2_FC_REPLAY_STOP indicates the end of replay (no more blocks remaining). A negative return value indicates error. h](j )}(h``j_fc_replay_callback``h]j)}(hj_h]hj_fc_replay_callback}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjYubj#)}(hhh]h)}(hXFile-system specific function that performs replay of a fast commit. JBD2 calls this function for each fast commit block found in the journal. This function should return JBD2_FC_REPLAY_CONTINUE to indicate that the block was processed correctly and more fast commit replay should continue. Return value of JBD2_FC_REPLAY_STOP indicates the end of replay (no more blocks remaining). A negative return value indicates error.h]hXFile-system specific function that performs replay of a fast commit. JBD2 calls this function for each fast commit block found in the journal. This function should return JBD2_FC_REPLAY_CONTINUE to indicate that the block was processed correctly and more fast commit replay should continue. Return value of JBD2_FC_REPLAY_STOP indicates the end of replay (no more blocks remaining). A negative return value indicates error.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjuubah}(h]h ]h"]h$]h&]uh1j"hjYubeh}(h]h ]h"]h$]h&]uh1jhjthMhju ubj)}(hV``j_bmap`` Bmap function that should be used instead of the generic VFS bmap function.h](j )}(h ``j_bmap``h]j)}(hjh]hj_bmap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:182: ./include/linux/jbd2.hhMhjubj#)}(hhh]h)}(hKBmap function that should be used instead of the generic VFS bmap function.h]hKBmap function that should be used instead of the generic VFS bmap function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1j"hjubeh}(h]h ]h"]h$]h&]uh1jhjhMhju ubeh}(h]h ]h"]h$]h&]uh1jhj- ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubeh}(h] structuresah ]h"] structuresah$]h&]uh1hhjjhhhhhKubeh}(h] data-typesah ]h"] data typesah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Functionsh]h Functions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hThe functions here are split into two groups those that affect a journal as a whole, and those which are used to manage transactionsh]hThe functions here are split into two groups those that affect a journal as a whole, and those which are used to manage transactions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(h Journal Levelh]h Journal Level}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j-jbd2_journal_force_commit_nested (C function)"c.jbd2_journal_force_commit_nestedhNtauh1jhjhhhNhNubj)}(hhh](j)}(h9int jbd2_journal_force_commit_nested (journal_t *journal)h]j)}(h8int jbd2_journal_force_commit_nested(journal_t *journal)h](hdesc_sig_keyword_type)}(hinth]hint}(hj4hhhNhNubah}(h]h ]ktah"]h$]h&]uh1j2hj.hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhjChMubj)}(h jbd2_journal_force_commit_nestedh]j)}(h jbd2_journal_force_commit_nestedh]h jbd2_journal_force_commit_nested}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ](jjeh"]h$]h&]jjuh1jhj.hhhjChMubhdesc_parameterlist)}(h(journal_t *journal)h]hdesc_parameter)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&] refdomainjmreftype identifier reftargetj{modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jjXsb"c.jbd2_journal_force_commit_nestedasbuh1hhjrubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjrubj)}(hjournalh]hjournal}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjlubah}(h]h ]h"]h$]h&]jjuh1jjhj.hhhjChMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj*hhhjChMubah}(h]j%ah ](j j eh"]h$]h&]jj)jhuh1jhjChMhj'hhubj)}(hhh]h)}(hNForce and wait upon a commit if the calling process is not within transaction.h]hNForce and wait upon a commit if the calling process is not within transaction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhj'hhhjChMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j j4j j5j6j7uh1jhhhjhNhNubj)}(h**Parameters** ``journal_t *journal`` journal to force Returns true if progress was made. **Description** This is used for forcing out undo-protected data which contains bitmaps, when the fs is running out of space.h](h)}(h**Parameters**h]j=)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj ubj)}(hhh]j)}(hK``journal_t *journal`` journal to force Returns true if progress was made. h](j )}(h``journal_t *journal``h]j)}(hj+ h]hjournal_t *journal}(hj- hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj) ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj% ubj#)}(hhh]h)}(h3journal to force Returns true if progress was made.h]h3journal to force Returns true if progress was made.}(hjD hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjA ubah}(h]h ]h"]h$]h&]uh1j"hj% ubeh}(h]h ]h"]h$]h&]uh1jhj@ hMhj" ubah}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j=)}(hjg h]h Description}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hje ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj ubh)}(hmThis is used for forcing out undo-protected data which contains bitmaps, when the fs is running out of space.h]hmThis is used for forcing out undo-protected data which contains bitmaps, when the fs is running out of space.}(hj} hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&jbd2_journal_force_commit (C function)c.jbd2_journal_force_commithNtauh1jhjhhhNhNubj)}(hhh](j)}(h2int jbd2_journal_force_commit (journal_t *journal)h]j)}(h1int jbd2_journal_force_commit(journal_t *journal)h](j3)}(hinth]hint}(hj hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM#ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hM#ubj)}(hjbd2_journal_force_commith]j)}(hjbd2_journal_force_commith]hjbd2_journal_force_commit}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj hhhj hM#ubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj modnameN classnameNjj)}j]j)}jj sbc.jbd2_journal_force_commitasbuh1hhj ubj)}(h h]h }(hj !hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjournalh]hjournal}(hj'!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj ubah}(h]h ]h"]h$]h&]jjuh1jjhj hhhj hM#ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj hhhj hM#ubah}(h]j ah ](j j eh"]h$]h&]jj)jhuh1jhj hM#hj hhubj)}(hhh]h)}(h"force any uncommitted transactionsh]h"force any uncommitted transactions}(hjQ!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM#hjN!hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj hM#ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3ji!j4ji!j5j6j7uh1jhhhjhNhNubj)}(h**Parameters** ``journal_t *journal`` journal to force **Description** Caller want unconditional commit. We can only force the running transaction if we don't have an active handle, otherwise, we will deadlock.h](h)}(h**Parameters**h]j=)}(hjs!h]h Parameters}(hju!hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjq!ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM'hjm!ubj)}(hhh]j)}(h(``journal_t *journal`` journal to force h](j )}(h``journal_t *journal``h]j)}(hj!h]hjournal_t *journal}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM$hj!ubj#)}(hhh]h)}(hjournal to forceh]hjournal to force}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hM$hj!ubah}(h]h ]h"]h$]h&]uh1j"hj!ubeh}(h]h ]h"]h$]h&]uh1jhj!hM$hj!ubah}(h]h ]h"]h$]h&]uh1jhjm!ubh)}(h**Description**h]j=)}(hj!h]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj!ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM&hjm!ubh)}(hCaller want unconditional commit. We can only force the running transaction if we don't have an active handle, otherwise, we will deadlock.h]hCaller want unconditional commit. We can only force the running transaction if we don’t have an active handle, otherwise, we will deadlock.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM%hjm!ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"jbd2_journal_init_dev (C function)c.jbd2_journal_init_devhNtauh1jhjhhhNhNubj)}(hhh](j)}(hjournal_t * jbd2_journal_init_dev (struct block_device *bdev, struct block_device *fs_dev, unsigned long long start, int len, int blocksize)h]j)}(hjournal_t *jbd2_journal_init_dev(struct block_device *bdev, struct block_device *fs_dev, unsigned long long start, int len, int blocksize)h](h)}(hhh]j)}(h journal_th]h journal_t}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj"modnameN classnameNjj)}j]j)}jjbd2_journal_init_devsbc.jbd2_journal_init_devasbuh1hhj"hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM[ubj)}(h h]h }(hj7"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj6"hM[ubj)}(hjh]h*}(hjE"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhhj6"hM[ubj)}(hjbd2_journal_init_devh]j)}(hj3"h]hjbd2_journal_init_dev}(hjV"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR"ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj"hhhj6"hM[ubjk)}(hj(struct block_device *bdev, struct block_device *fs_dev, unsigned long long start, int len, int blocksize)h](jq)}(hstruct block_device *bdevh](j)}(hjVh]hstruct}(hjq"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm"ubj)}(h h]h }(hj~"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm"ubh)}(hhh]j)}(h block_deviceh]h block_device}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj"modnameN classnameNjj)}j]j1"c.jbd2_journal_init_devasbuh1hhjm"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm"ubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm"ubj)}(hbdevh]hbdev}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm"ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphji"ubjq)}(hstruct block_device *fs_devh](j)}(hjVh]hstruct}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(h block_deviceh]h block_device}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj#modnameN classnameNjj)}j]j1"c.jbd2_journal_init_devasbuh1hhj"ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hjh]h*}(hj+#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(hfs_devh]hfs_dev}(hj8#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphji"ubjq)}(hunsigned long long starth](j3)}(hunsignedh]hunsigned}(hjQ#hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjM#ubj)}(h h]h }(hj_#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM#ubj3)}(hlongh]hlong}(hjm#hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjM#ubj)}(h h]h }(hj{#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM#ubj3)}(hlongh]hlong}(hj#hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjM#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM#ubj)}(hstarth]hstart}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM#ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphji"ubjq)}(hint lenh](j3)}(hinth]hint}(hj#hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj#ubj)}(h h]h }(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(hlenh]hlen}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphji"ubjq)}(h int blocksizeh](j3)}(hinth]hint}(hj#hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj#ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h blocksizeh]h blocksize}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphji"ubeh}(h]h ]h"]h$]h&]jjuh1jjhj"hhhj6"hM[ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj "hhhj6"hM[ubah}(h]j"ah ](j j eh"]h$]h&]jj)jhuh1jhj6"hM[hj"hhubj)}(hhh]h)}(h+creates and initialises a journal structureh]h+creates and initialises a journal structure}(hj9$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM[hj6$hhubah}(h]h ]h"]h$]h&]uh1jhj"hhhj6"hM[ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jQ$j4jQ$j5j6j7uh1jhhhjhNhNubj)}(hX **Parameters** ``struct block_device *bdev`` Block device on which to create the journal ``struct block_device *fs_dev`` Device which hold journalled filesystem for this journal. ``unsigned long long start`` Block nr Start of journal. ``int len`` Length of the journal in blocks. ``int blocksize`` blocksize of journalling device **Return** a newly created journal_t * **Description** jbd2_journal_init_dev creates a journal which maps a fixed contiguous range of blocks on an arbitrary block device.h](h)}(h**Parameters**h]j=)}(hj[$h]h Parameters}(hj]$hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjY$ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM_hjU$ubj)}(hhh](j)}(hJ``struct block_device *bdev`` Block device on which to create the journal h](j )}(h``struct block_device *bdev``h]j)}(hjz$h]hstruct block_device *bdev}(hj|$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjx$ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM\hjt$ubj#)}(hhh]h)}(h+Block device on which to create the journalh]h+Block device on which to create the journal}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hM\hj$ubah}(h]h ]h"]h$]h&]uh1j"hjt$ubeh}(h]h ]h"]h$]h&]uh1jhj$hM\hjq$ubj)}(hZ``struct block_device *fs_dev`` Device which hold journalled filesystem for this journal. h](j )}(h``struct block_device *fs_dev``h]j)}(hj$h]hstruct block_device *fs_dev}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM]hj$ubj#)}(hhh]h)}(h9Device which hold journalled filesystem for this journal.h]h9Device which hold journalled filesystem for this journal.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hM]hj$ubah}(h]h ]h"]h$]h&]uh1j"hj$ubeh}(h]h ]h"]h$]h&]uh1jhj$hM]hjq$ubj)}(h8``unsigned long long start`` Block nr Start of journal. h](j )}(h``unsigned long long start``h]j)}(hj$h]hunsigned long long start}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM^hj$ubj#)}(hhh]h)}(hBlock nr Start of journal.h]hBlock nr Start of journal.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hM^hj%ubah}(h]h ]h"]h$]h&]uh1j"hj$ubeh}(h]h ]h"]h$]h&]uh1jhj%hM^hjq$ubj)}(h-``int len`` Length of the journal in blocks. h](j )}(h ``int len``h]j)}(hj%%h]hint len}(hj'%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#%ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM_hj%ubj#)}(hhh]h)}(h Length of the journal in blocks.h]h Length of the journal in blocks.}(hj>%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:%hM_hj;%ubah}(h]h ]h"]h$]h&]uh1j"hj%ubeh}(h]h ]h"]h$]h&]uh1jhj:%hM_hjq$ubj)}(h2``int blocksize`` blocksize of journalling device h](j )}(h``int blocksize``h]j)}(hj^%h]h int blocksize}(hj`%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\%ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM`hjX%ubj#)}(hhh]h)}(hblocksize of journalling deviceh]hblocksize of journalling device}(hjw%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjs%hM`hjt%ubah}(h]h ]h"]h$]h&]uh1j"hjX%ubeh}(h]h ]h"]h$]h&]uh1jhjs%hM`hjq$ubeh}(h]h ]h"]h$]h&]uh1jhjU$ubh)}(h **Return**h]j=)}(hj%h]hReturn}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj%ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMbhjU$ubh)}(ha newly created journal_t *h]ha newly created journal_t *}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMbhjU$ubh)}(h**Description**h]j=)}(hj%h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj%ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMdhjU$ubh block_quote)}(hsjbd2_journal_init_dev creates a journal which maps a fixed contiguous range of blocks on an arbitrary block device.h]h)}(hsjbd2_journal_init_dev creates a journal which maps a fixed contiguous range of blocks on an arbitrary block device.h]hsjbd2_journal_init_dev creates a journal which maps a fixed contiguous range of blocks on an arbitrary block device.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMchj%ubah}(h]h ]h"]h$]h&]uh1j%hj%hMchjU$ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$jbd2_journal_init_inode (C function)c.jbd2_journal_init_inodehNtauh1jhjhhhNhNubj)}(hhh](j)}(h9journal_t * jbd2_journal_init_inode (struct inode *inode)h]j)}(h7journal_t *jbd2_journal_init_inode(struct inode *inode)h](h)}(hhh]j)}(h journal_th]h journal_t}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj&modnameN classnameNjj)}j]j)}jjbd2_journal_init_inodesbc.jbd2_journal_init_inodeasbuh1hhj &hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM{ubj)}(h h]h }(hj6&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj &hhhj5&hM{ubj)}(hjh]h*}(hjD&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj &hhhj5&hM{ubj)}(hjbd2_journal_init_inodeh]j)}(hj2&h]hjbd2_journal_init_inode}(hjU&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQ&ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj &hhhj5&hM{ubjk)}(h(struct inode *inode)h]jq)}(hstruct inode *inodeh](j)}(hjVh]hstruct}(hjp&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl&ubj)}(h h]h }(hj}&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl&ubh)}(hhh]j)}(hinodeh]hinode}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj&modnameN classnameNjj)}j]j0&c.jbd2_journal_init_inodeasbuh1hhjl&ubj)}(h h]h }(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl&ubj)}(hjh]h*}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl&ubj)}(hinodeh]hinode}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjl&ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjh&ubah}(h]h ]h"]h$]h&]jjuh1jjhj &hhhj5&hM{ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj &hhhj5&hM{ubah}(h]j&ah ](j j eh"]h$]h&]jj)jhuh1jhj5&hM{hj&hhubj)}(hhh]h)}(h(creates a journal which maps to a inode.h]h(creates a journal which maps to a inode.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM{hj&hhubah}(h]h ]h"]h$]h&]uh1jhj&hhhj5&hM{ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j 'j4j 'j5j6j7uh1jhhhjhNhNubj)}(hX**Parameters** ``struct inode *inode`` An inode to create the journal in **Description** jbd2_journal_init_inode creates a journal which maps an on-disk inode as the journal. The inode must exist already, must support bmap() and must have all data blocks preallocated.h](h)}(h**Parameters**h]j=)}(hj'h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj'ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj 'ubj)}(hhh]j)}(h:``struct inode *inode`` An inode to create the journal in h](j )}(h``struct inode *inode``h]j)}(hj2'h]hstruct inode *inode}(hj4'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0'ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM|hj,'ubj#)}(hhh]h)}(h!An inode to create the journal inh]h!An inode to create the journal in}(hjK'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjG'hM|hjH'ubah}(h]h ]h"]h$]h&]uh1j"hj,'ubeh}(h]h ]h"]h$]h&]uh1jhjG'hM|hj)'ubah}(h]h ]h"]h$]h&]uh1jhj 'ubh)}(h**Description**h]j=)}(hjm'h]h Description}(hjo'hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjk'ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM~hj 'ubh)}(hjbd2_journal_init_inode creates a journal which maps an on-disk inode as the journal. The inode must exist already, must support bmap() and must have all data blocks preallocated.h]hjbd2_journal_init_inode creates a journal which maps an on-disk inode as the journal. The inode must exist already, must support bmap() and must have all data blocks preallocated.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM}hj 'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j)jbd2_journal_update_sb_errno (C function)c.jbd2_journal_update_sb_errnohNtauh1jhjhhhNhNubj)}(hhh](j)}(h6void jbd2_journal_update_sb_errno (journal_t *journal)h]j)}(h5void jbd2_journal_update_sb_errno(journal_t *journal)h](j3)}(hvoidh]hvoid}(hj'hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj'hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMubj)}(h h]h }(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'hhhj'hMubj)}(hjbd2_journal_update_sb_errnoh]j)}(hjbd2_journal_update_sb_errnoh]hjbd2_journal_update_sb_errno}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj'hhhj'hMubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj'modnameN classnameNjj)}j]j)}jj'sbc.jbd2_journal_update_sb_errnoasbuh1hhj'ubj)}(h h]h }(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(hjh]h*}(hj (hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubj)}(hjournalh]hjournal}(hj-(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj'ubah}(h]h ]h"]h$]h&]jjuh1jjhj'hhhj'hMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj'hhhj'hMubah}(h]j'ah ](j j eh"]h$]h&]jj)jhuh1jhj'hMhj'hhubj)}(hhh]h)}(hUpdate error in the journal.h]hUpdate error in the journal.}(hjW(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjT(hhubah}(h]h ]h"]h$]h&]uh1jhj'hhhj'hMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jo(j4jo(j5j6j7uh1jhhhjhNhNubj)}(h**Parameters** ``journal_t *journal`` The journal to update. **Description** Update a journal's errno. Write updated superblock to disk waiting for IO to complete.h](h)}(h**Parameters**h]j=)}(hjy(h]h Parameters}(hj{(hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjw(ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjs(ubj)}(hhh]j)}(h.``journal_t *journal`` The journal to update. h](j )}(h``journal_t *journal``h]j)}(hj(h]hjournal_t *journal}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj(ubj#)}(hhh]h)}(hThe journal to update.h]hThe journal to update.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1j"hj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhj(ubah}(h]h ]h"]h$]h&]uh1jhjs(ubh)}(h**Description**h]j=)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj(ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjs(ubh)}(hWUpdate a journal's errno. Write updated superblock to disk waiting for IO to complete.h]hYUpdate a journal’s errno. Write updated superblock to disk waiting for IO to complete.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjs(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_journal_load (C function)c.jbd2_journal_loadhNtauh1jhjhhhNhNubj)}(hhh](j)}(h*int jbd2_journal_load (journal_t *journal)h]j)}(h)int jbd2_journal_load(journal_t *journal)h](j3)}(hinth]hint}(hj)hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj)hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMubj)}(h h]h }(hj')hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)hhhj&)hMubj)}(hjbd2_journal_loadh]j)}(hjbd2_journal_loadh]hjbd2_journal_load}(hj9)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5)ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj)hhhj&)hMubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjX)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjU)ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjZ)modnameN classnameNjj)}j]j)}jj;)sbc.jbd2_journal_loadasbuh1hhjQ)ubj)}(h h]h }(hjx)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQ)ubj)}(hjh]h*}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQ)ubj)}(hjournalh]hjournal}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQ)ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjM)ubah}(h]h ]h"]h$]h&]jjuh1jjhj)hhhj&)hMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj)hhhj&)hMubah}(h]j )ah ](j j eh"]h$]h&]jj)jhuh1jhj&)hMhj )hhubj)}(hhh]h)}(hRead journal from disk.h]hRead journal from disk.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj)hhubah}(h]h ]h"]h$]h&]uh1jhj )hhhj&)hMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j)j4j)j5j6j7uh1jhhhjhNhNubj)}(h**Parameters** ``journal_t *journal`` Journal to act on. **Description** Given a journal_t structure which tells us which disk blocks contain a journal, read the journal from disk to initialise the in-memory structures.h](h)}(h**Parameters**h]j=)}(hj)h]h Parameters}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj)ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj)ubj)}(hhh]j)}(h*``journal_t *journal`` Journal to act on. h](j )}(h``journal_t *journal``h]j)}(hj)h]hjournal_t *journal}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj)ubj#)}(hhh]h)}(hJournal to act on.h]hJournal to act on.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMhj*ubah}(h]h ]h"]h$]h&]uh1j"hj)ubeh}(h]h ]h"]h$]h&]uh1jhj*hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj)ubh)}(h**Description**h]j=)}(hj9*h]h Description}(hj;*hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj7*ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj)ubh)}(hGiven a journal_t structure which tells us which disk blocks contain a journal, read the journal from disk to initialise the in-memory structures.h]hGiven a journal_t structure which tells us which disk blocks contain a journal, read the journal from disk to initialise the in-memory structures.}(hjO*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj)ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!jbd2_journal_destroy (C function)c.jbd2_journal_destroyhNtauh1jhjhhhNhNubj)}(hhh](j)}(h-int jbd2_journal_destroy (journal_t *journal)h]j)}(h,int jbd2_journal_destroy(journal_t *journal)h](j3)}(hinth]hint}(hj~*hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjz*hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM3ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz*hhhj*hM3ubj)}(hjbd2_journal_destroyh]j)}(hjbd2_journal_destroyh]hjbd2_journal_destroy}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ](jjeh"]h$]h&]jjuh1jhjz*hhhj*hM3ubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj*modnameN classnameNjj)}j]j)}jj*sbc.jbd2_journal_destroyasbuh1hhj*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hjh]h*}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubj)}(hjournalh]hjournal}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj*ubah}(h]h ]h"]h$]h&]jjuh1jjhjz*hhhj*hM3ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjv*hhhj*hM3ubah}(h]jq*ah ](j j eh"]h$]h&]jj)jhuh1jhj*hM3hjs*hhubj)}(hhh]h)}(hRelease a journal_t structure.h]hRelease a journal_t structure.}(hj#+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM3hj +hhubah}(h]h ]h"]h$]h&]uh1jhjs*hhhj*hM3ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j;+j4j;+j5j6j7uh1jhhhjhNhNubj)}(h**Parameters** ``journal_t *journal`` Journal to act on. **Description** Release a journal_t structure once it is no longer in use by the journaled object. Return <0 if we couldn't clean up the journal.h](h)}(h**Parameters**h]j=)}(hjE+h]h Parameters}(hjG+hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjC+ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM7hj?+ubj)}(hhh]j)}(h*``journal_t *journal`` Journal to act on. h](j )}(h``journal_t *journal``h]j)}(hjd+h]hjournal_t *journal}(hjf+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjb+ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM4hj^+ubj#)}(hhh]h)}(hJournal to act on.h]hJournal to act on.}(hj}+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjy+hM4hjz+ubah}(h]h ]h"]h$]h&]uh1j"hj^+ubeh}(h]h ]h"]h$]h&]uh1jhjy+hM4hj[+ubah}(h]h ]h"]h$]h&]uh1jhj?+ubh)}(h**Description**h]j=)}(hj+h]h Description}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj+ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM6hj?+ubh)}(hRelease a journal_t structure once it is no longer in use by the journaled object. Return <0 if we couldn't clean up the journal.h]hRelease a journal_t structure once it is no longer in use by the journaled object. Return <0 if we couldn’t clean up the journal.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM5hj?+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j-jbd2_journal_check_used_features (C function)"c.jbd2_journal_check_used_featureshNtauh1jhjhhhNhNubj)}(hhh](j)}(hyint jbd2_journal_check_used_features (journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h]j)}(hxint jbd2_journal_check_used_features(journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h](j3)}(hinth]hint}(hj+hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj+hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+hhhj+hMubj)}(h jbd2_journal_check_used_featuresh]j)}(h jbd2_journal_check_used_featuresh]h jbd2_journal_check_used_features}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj+hhhj+hMubjk)}(hT(journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj$,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!,ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj&,modnameN classnameNjj)}j]j)}jj,sb"c.jbd2_journal_check_used_featuresasbuh1hhj,ubj)}(h h]h }(hjD,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hjh]h*}(hjR,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hjournalh]hjournal}(hj_,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj,ubjq)}(hunsigned long compath](j3)}(hunsignedh]hunsigned}(hjx,hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjt,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjt,ubj3)}(hlongh]hlong}(hj,hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjt,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjt,ubj)}(hcompath]hcompat}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjt,ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj,ubjq)}(hunsigned long roh](j3)}(hunsignedh]hunsigned}(hj,hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj3)}(hlongh]hlong}(hj,hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj,ubj)}(h h]h }(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubj)}(hroh]hro}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj,ubjq)}(hunsigned long incompath](j3)}(hunsignedh]hunsigned}(hj-hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj-ubj)}(h h]h }(hj(-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj3)}(hlongh]hlong}(hj6-hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj-ubj)}(h h]h }(hjD-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubj)}(hincompath]hincompat}(hjR-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj,ubeh}(h]h ]h"]h$]h&]jjuh1jjhj+hhhj+hMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj+hhhj+hMubah}(h]j+ah ](j j eh"]h$]h&]jj)jhuh1jhj+hMhj+hhubj)}(hhh]h)}(h%Check if features specified are used.h]h%Check if features specified are used.}(hj|-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjy-hhubah}(h]h ]h"]h$]h&]uh1jhj+hhhj+hMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j-j4j-j5j6j7uh1jhhhjhNhNubj)}(hXp**Parameters** ``journal_t *journal`` Journal to check. ``unsigned long compat`` bitmask of compatible features ``unsigned long ro`` bitmask of features that force read-only mount ``unsigned long incompat`` bitmask of incompatible features **Description** Check whether the journal uses all of a given set of features. Return true (non-zero) if it does.h](h)}(h**Parameters**h]j=)}(hj-h]h Parameters}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj-ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj-ubj)}(hhh](j)}(h)``journal_t *journal`` Journal to check. h](j )}(h``journal_t *journal``h]j)}(hj-h]hjournal_t *journal}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj-ubj#)}(hhh]h)}(hJournal to check.h]hJournal to check.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hMhj-ubah}(h]h ]h"]h$]h&]uh1j"hj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hMhj-ubj)}(h8``unsigned long compat`` bitmask of compatible features h](j )}(h``unsigned long compat``h]j)}(hj-h]hunsigned long compat}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj-ubj#)}(hhh]h)}(hbitmask of compatible featuresh]hbitmask of compatible features}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj .hMhj .ubah}(h]h ]h"]h$]h&]uh1j"hj-ubeh}(h]h ]h"]h$]h&]uh1jhj .hMhj-ubj)}(hD``unsigned long ro`` bitmask of features that force read-only mount h](j )}(h``unsigned long ro``h]j)}(hj/.h]hunsigned long ro}(hj1.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-.ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj).ubj#)}(hhh]h)}(h.bitmask of features that force read-only mounth]h.bitmask of features that force read-only mount}(hjH.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjD.hMhjE.ubah}(h]h ]h"]h$]h&]uh1j"hj).ubeh}(h]h ]h"]h$]h&]uh1jhjD.hMhj-ubj)}(h<``unsigned long incompat`` bitmask of incompatible features h](j )}(h``unsigned long incompat``h]j)}(hjh.h]hunsigned long incompat}(hjj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjf.ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjb.ubj#)}(hhh]h)}(h bitmask of incompatible featuresh]h bitmask of incompatible features}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}.hMhj~.ubah}(h]h ]h"]h$]h&]uh1j"hjb.ubeh}(h]h ]h"]h$]h&]uh1jhj}.hMhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-ubh)}(h**Description**h]j=)}(hj.h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj.ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj-ubh)}(hbCheck whether the journal uses all of a given set of features. Return true (non-zero) if it does.h]hbCheck whether the journal uses all of a given set of features. Return true (non-zero) if it does.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj-ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j2jbd2_journal_check_available_features (C function)'c.jbd2_journal_check_available_featureshNtauh1jhjhhhNhNubj)}(hhh](j)}(h~int jbd2_journal_check_available_features (journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h]j)}(h}int jbd2_journal_check_available_features(journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h](j3)}(hinth]hint}(hj.hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj.hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMubj)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj.hhhj.hMubj)}(h%jbd2_journal_check_available_featuresh]j)}(h%jbd2_journal_check_available_featuresh]h%jbd2_journal_check_available_features}(hj /hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj.hhhj.hMubjk)}(hT(journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj(/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%/ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj*/modnameN classnameNjj)}j]j)}jj /sb'c.jbd2_journal_check_available_featuresasbuh1hhj!/ubj)}(h h]h }(hjH/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!/ubj)}(hjh]h*}(hjV/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!/ubj)}(hjournalh]hjournal}(hjc/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!/ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj/ubjq)}(hunsigned long compath](j3)}(hunsignedh]hunsigned}(hj|/hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjx/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx/ubj3)}(hlongh]hlong}(hj/hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjx/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx/ubj)}(hcompath]hcompat}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjx/ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj/ubjq)}(hunsigned long roh](j3)}(hunsignedh]hunsigned}(hj/hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj3)}(hlongh]hlong}(hj/hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj/ubj)}(h h]h }(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubj)}(hroh]hro}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj/ubjq)}(hunsigned long incompath](j3)}(hunsignedh]hunsigned}(hj0hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj0ubj)}(h h]h }(hj,0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj3)}(hlongh]hlong}(hj:0hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj0ubj)}(h h]h }(hjH0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubj)}(hincompath]hincompat}(hjV0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj/ubeh}(h]h ]h"]h$]h&]jjuh1jjhj.hhhj.hMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj.hhhj.hMubah}(h]j.ah ](j j eh"]h$]h&]jj)jhuh1jhj.hMhj.hhubj)}(hhh]h)}(h&Check feature set in journalling layerh]h&Check feature set in journalling layer}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj}0hhubah}(h]h ]h"]h$]h&]uh1jhj.hhhj.hMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j0j4j0j5j6j7uh1jhhhjhNhNubj)}(hX**Parameters** ``journal_t *journal`` Journal to check. ``unsigned long compat`` bitmask of compatible features ``unsigned long ro`` bitmask of features that force read-only mount ``unsigned long incompat`` bitmask of incompatible features **Description** Check whether the journaling code supports the use of all of a given set of features on this journal. Return trueh](h)}(h**Parameters**h]j=)}(hj0h]h Parameters}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj0ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj0ubj)}(hhh](j)}(h)``journal_t *journal`` Journal to check. h](j )}(h``journal_t *journal``h]j)}(hj0h]hjournal_t *journal}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj0ubj#)}(hhh]h)}(hJournal to check.h]hJournal to check.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1j"hj0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhj0ubj)}(h8``unsigned long compat`` bitmask of compatible features h](j )}(h``unsigned long compat``h]j)}(hj0h]hunsigned long compat}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj0ubj#)}(hhh]h)}(hbitmask of compatible featuresh]hbitmask of compatible features}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMhj1ubah}(h]h ]h"]h$]h&]uh1j"hj0ubeh}(h]h ]h"]h$]h&]uh1jhj1hMhj0ubj)}(hD``unsigned long ro`` bitmask of features that force read-only mount h](j )}(h``unsigned long ro``h]j)}(hj31h]hunsigned long ro}(hj51hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj11ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj-1ubj#)}(hhh]h)}(h.bitmask of features that force read-only mounth]h.bitmask of features that force read-only mount}(hjL1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjH1hMhjI1ubah}(h]h ]h"]h$]h&]uh1j"hj-1ubeh}(h]h ]h"]h$]h&]uh1jhjH1hMhj0ubj)}(h<``unsigned long incompat`` bitmask of incompatible features h](j )}(h``unsigned long incompat``h]j)}(hjl1h]hunsigned long incompat}(hjn1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjj1ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjf1ubj#)}(hhh]h)}(h bitmask of incompatible featuresh]h bitmask of incompatible features}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMhj1ubah}(h]h ]h"]h$]h&]uh1j"hjf1ubeh}(h]h ]h"]h$]h&]uh1jhj1hMhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0ubh)}(h**Description**h]j=)}(hj1h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj1ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj0ubh)}(hrCheck whether the journaling code supports the use of all of a given set of features on this journal. Return trueh]hrCheck whether the journaling code supports the use of all of a given set of features on this journal. Return true}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&jbd2_journal_set_features (C function)c.jbd2_journal_set_featureshNtauh1jhjhhhNhNubj)}(hhh](j)}(hrint jbd2_journal_set_features (journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h]j)}(hqint jbd2_journal_set_features(journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h](j3)}(hinth]hint}(hj1hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj1hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1hhhj1hMubj)}(hjbd2_journal_set_featuresh]j)}(hjbd2_journal_set_featuresh]hjbd2_journal_set_features}(hj 2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 2ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj1hhhj1hMubjk)}(hT(journal_t *journal, unsigned long compat, unsigned long ro, unsigned long incompat)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj,2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)2ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj.2modnameN classnameNjj)}j]j)}jj2sbc.jbd2_journal_set_featuresasbuh1hhj%2ubj)}(h h]h }(hjL2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%2ubj)}(hjh]h*}(hjZ2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%2ubj)}(hjournalh]hjournal}(hjg2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%2ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj!2ubjq)}(hunsigned long compath](j3)}(hunsignedh]hunsigned}(hj2hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj|2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|2ubj3)}(hlongh]hlong}(hj2hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj|2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|2ubj)}(hcompath]hcompat}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|2ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj!2ubjq)}(hunsigned long roh](j3)}(hunsignedh]hunsigned}(hj2hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj3)}(hlongh]hlong}(hj2hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubj)}(hroh]hro}(hj 3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj!2ubjq)}(hunsigned long incompath](j3)}(hunsignedh]hunsigned}(hj"3hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj3ubj)}(h h]h }(hj03hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj3)}(hlongh]hlong}(hj>3hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj3ubj)}(h h]h }(hjL3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubj)}(hincompath]hincompat}(hjZ3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj!2ubeh}(h]h ]h"]h$]h&]jjuh1jjhj1hhhj1hMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj1hhhj1hMubah}(h]j1ah ](j j eh"]h$]h&]jj)jhuh1jhj1hMhj1hhubj)}(hhh]h)}(h.Mark a given journal feature in the superblockh]h.Mark a given journal feature in the superblock}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj3hhubah}(h]h ]h"]h$]h&]uh1jhj1hhhj1hMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j3j4j3j5j6j7uh1jhhhjhNhNubj)}(hX**Parameters** ``journal_t *journal`` Journal to act on. ``unsigned long compat`` bitmask of compatible features ``unsigned long ro`` bitmask of features that force read-only mount ``unsigned long incompat`` bitmask of incompatible features **Description** Mark a given journal feature as present on the superblock. Returns true if the requested features could be set.h](h)}(h**Parameters**h]j=)}(hj3h]h Parameters}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj3ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj3ubj)}(hhh](j)}(h*``journal_t *journal`` Journal to act on. h](j )}(h``journal_t *journal``h]j)}(hj3h]hjournal_t *journal}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj3ubj#)}(hhh]h)}(hJournal to act on.h]hJournal to act on.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMhj3ubah}(h]h ]h"]h$]h&]uh1j"hj3ubeh}(h]h ]h"]h$]h&]uh1jhj3hMhj3ubj)}(h8``unsigned long compat`` bitmask of compatible features h](j )}(h``unsigned long compat``h]j)}(hj3h]hunsigned long compat}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj3ubj#)}(hhh]h)}(hbitmask of compatible featuresh]hbitmask of compatible features}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1j"hj3ubeh}(h]h ]h"]h$]h&]uh1jhj4hMhj3ubj)}(hD``unsigned long ro`` bitmask of features that force read-only mount h](j )}(h``unsigned long ro``h]j)}(hj74h]hunsigned long ro}(hj94hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj54ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj14ubj#)}(hhh]h)}(h.bitmask of features that force read-only mounth]h.bitmask of features that force read-only mount}(hjP4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjL4hMhjM4ubah}(h]h ]h"]h$]h&]uh1j"hj14ubeh}(h]h ]h"]h$]h&]uh1jhjL4hMhj3ubj)}(h<``unsigned long incompat`` bitmask of incompatible features h](j )}(h``unsigned long incompat``h]j)}(hjp4h]hunsigned long incompat}(hjr4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjn4ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhjj4ubj#)}(hhh]h)}(h bitmask of incompatible featuresh]h bitmask of incompatible features}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1j"hjj4ubeh}(h]h ]h"]h$]h&]uh1jhj4hMhj3ubeh}(h]h ]h"]h$]h&]uh1jhj3ubh)}(h**Description**h]j=)}(hj4h]h Description}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj4ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj3ubh)}(hpMark a given journal feature as present on the superblock. Returns true if the requested features could be set.h]hpMark a given journal feature as present on the superblock. Returns true if the requested features could be set.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMhj3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_journal_flush (C function)c.jbd2_journal_flushhNtauh1jhjhhhNhNubj)}(hhh](j)}(h?int jbd2_journal_flush (journal_t *journal, unsigned int flags)h]j)}(h>int jbd2_journal_flush(journal_t *journal, unsigned int flags)h](j3)}(hinth]hint}(hj4hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj4hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM] ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4hhhj4hM] ubj)}(hjbd2_journal_flushh]j)}(hjbd2_journal_flushh]hjbd2_journal_flush}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 5ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj4hhhj4hM] ubjk)}(h((journal_t *journal, unsigned int flags)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj05hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-5ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj25modnameN classnameNjj)}j]j)}jj5sbc.jbd2_journal_flushasbuh1hhj)5ubj)}(h h]h }(hjP5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)5ubj)}(hjh]h*}(hj^5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)5ubj)}(hjournalh]hjournal}(hjk5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)5ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj%5ubjq)}(hunsigned int flagsh](j3)}(hunsignedh]hunsigned}(hj5hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj3)}(hinth]hint}(hj5hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubj)}(hflagsh]hflags}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj%5ubeh}(h]h ]h"]h$]h&]jjuh1jjhj4hhhj4hM] ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj4hhhj4hM] ubah}(h]j4ah ](j j eh"]h$]h&]jj)jhuh1jhj4hM] hj4hhubj)}(hhh]h)}(h Flush journalh]h Flush journal}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM] hj5hhubah}(h]h ]h"]h$]h&]uh1jhj4hhhj4hM] ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j5j4j5j5j6j7uh1jhhhjhNhNubj)}(hXI**Parameters** ``journal_t *journal`` Journal to act on. ``unsigned int flags`` optional operation on the journal blocks after the flush (see below) **Description** Flush all data for a given journal to disk and empty the journal. Filesystems can use this when remounting readonly to ensure that recovery does not need to happen on remount. Optionally, a discard or zeroout can be issued on the journal blocks after flushing. flags: JBD2_JOURNAL_FLUSH_DISCARD: issues discards for the journal blocks JBD2_JOURNAL_FLUSH_ZEROOUT: issues zeroouts for the journal blocksh](h)}(h**Parameters**h]j=)}(hj6h]h Parameters}(hj 6hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj6ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMa hj6ubj)}(hhh](j)}(h*``journal_t *journal`` Journal to act on. h](j )}(h``journal_t *journal``h]j)}(hj'6h]hjournal_t *journal}(hj)6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%6ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM^ hj!6ubj#)}(hhh]h)}(hJournal to act on.h]hJournal to act on.}(hj@6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<6hM^ hj=6ubah}(h]h ]h"]h$]h&]uh1j"hj!6ubeh}(h]h ]h"]h$]h&]uh1jhj<6hM^ hj6ubj)}(h\``unsigned int flags`` optional operation on the journal blocks after the flush (see below) h](j )}(h``unsigned int flags``h]j)}(hj`6h]hunsigned int flags}(hjb6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^6ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM_ hjZ6ubj#)}(hhh]h)}(hDoptional operation on the journal blocks after the flush (see below)h]hDoptional operation on the journal blocks after the flush (see below)}(hjy6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhju6hM_ hjv6ubah}(h]h ]h"]h$]h&]uh1j"hjZ6ubeh}(h]h ]h"]h$]h&]uh1jhju6hM_ hj6ubeh}(h]h ]h"]h$]h&]uh1jhj6ubh)}(h**Description**h]j=)}(hj6h]h Description}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj6ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMa hj6ubh)}(hXFlush all data for a given journal to disk and empty the journal. Filesystems can use this when remounting readonly to ensure that recovery does not need to happen on remount. Optionally, a discard or zeroout can be issued on the journal blocks after flushing.h]hXFlush all data for a given journal to disk and empty the journal. Filesystems can use this when remounting readonly to ensure that recovery does not need to happen on remount. Optionally, a discard or zeroout can be issued on the journal blocks after flushing.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM` hj6ubj)}(hhh]j)}(hflags: JBD2_JOURNAL_FLUSH_DISCARD: issues discards for the journal blocks JBD2_JOURNAL_FLUSH_ZEROOUT: issues zeroouts for the journal blocksh](j )}(hflags:h]hflags:}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMf hj6ubj#)}(hhh]h)}(hJBD2_JOURNAL_FLUSH_DISCARD: issues discards for the journal blocks JBD2_JOURNAL_FLUSH_ZEROOUT: issues zeroouts for the journal blocksh]hJBD2_JOURNAL_FLUSH_DISCARD: issues discards for the journal blocks JBD2_JOURNAL_FLUSH_ZEROOUT: issues zeroouts for the journal blocks}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6hMf hj6ubah}(h]h ]h"]h$]h&]uh1j"hj6ubeh}(h]h ]h"]h$]h&]uh1jhj6hMf hj6ubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_journal_wipe (C function)c.jbd2_journal_wipehNtauh1jhjhhhNhNubj)}(hhh](j)}(h5int jbd2_journal_wipe (journal_t *journal, int write)h]j)}(h4int jbd2_journal_wipe(journal_t *journal, int write)h](j3)}(hinth]hint}(hj7hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj7hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM ubj)}(h h]h }(hj(7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7hhhj'7hM ubj)}(hjbd2_journal_wipeh]j)}(hjbd2_journal_wipeh]hjbd2_journal_wipe}(hj:7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj67ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj7hhhj'7hM ubjk)}(h(journal_t *journal, int write)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjY7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjV7ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj[7modnameN classnameNjj)}j]j)}jj<7sbc.jbd2_journal_wipeasbuh1hhjR7ubj)}(h h]h }(hjy7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR7ubj)}(hjh]h*}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR7ubj)}(hjournalh]hjournal}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjR7ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjN7ubjq)}(h int writeh](j3)}(hinth]hint}(hj7hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(hwriteh]hwrite}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjN7ubeh}(h]h ]h"]h$]h&]jjuh1jjhj7hhhj'7hM ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj7hhhj'7hM ubah}(h]j 7ah ](j j eh"]h$]h&]jj)jhuh1jhj'7hM hj7hhubj)}(hhh]h)}(hWipe journal contentsh]hWipe journal contents}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj7hhubah}(h]h ]h"]h$]h&]uh1jhj7hhhj'7hM ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j 8j4j 8j5j6j7uh1jhhhjhNhNubj)}(hX**Parameters** ``journal_t *journal`` Journal to act on. ``int write`` flag (see below) **Description** Wipe out all of the contents of a journal, safely. This will produce a warning if the journal contains any valid recovery information. Must be called between journal_init_*() and jbd2_journal_load(). If 'write' is non-zero, then we wipe out the journal on disk; otherwise we merely suppress recovery.h](h)}(h**Parameters**h]j=)}(hj8h]h Parameters}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj8ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj8ubj)}(hhh](j)}(h*``journal_t *journal`` Journal to act on. h](j )}(h``journal_t *journal``h]j)}(hj48h]hjournal_t *journal}(hj68hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj28ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj.8ubj#)}(hhh]h)}(hJournal to act on.h]hJournal to act on.}(hjM8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjI8hM hjJ8ubah}(h]h ]h"]h$]h&]uh1j"hj.8ubeh}(h]h ]h"]h$]h&]uh1jhjI8hM hj+8ubj)}(h``int write`` flag (see below) h](j )}(h ``int write``h]j)}(hjm8h]h int write}(hjo8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk8ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hjg8ubj#)}(hhh]h)}(hflag (see below)h]hflag (see below)}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hM hj8ubah}(h]h ]h"]h$]h&]uh1j"hjg8ubeh}(h]h ]h"]h$]h&]uh1jhj8hM hj+8ubeh}(h]h ]h"]h$]h&]uh1jhj8ubh)}(h**Description**h]j=)}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj8ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj8ubh)}(hWipe out all of the contents of a journal, safely. This will produce a warning if the journal contains any valid recovery information. Must be called between journal_init_*() and jbd2_journal_load().h]hWipe out all of the contents of a journal, safely. This will produce a warning if the journal contains any valid recovery information. Must be called between journal_init_*() and jbd2_journal_load().}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj8ubh)}(hdIf 'write' is non-zero, then we wipe out the journal on disk; otherwise we merely suppress recovery.h]hhIf ‘write’ is non-zero, then we wipe out the journal on disk; otherwise we merely suppress recovery.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_journal_abort (C function)c.jbd2_journal_aborthNtauh1jhjhhhNhNubj)}(hhh](j)}(h7void jbd2_journal_abort (journal_t *journal, int errno)h]j)}(h6void jbd2_journal_abort(journal_t *journal, int errno)h](j3)}(hvoidh]hvoid}(hj8hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj8hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM ubj)}(h h]h }(hj 9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8hhhj 9hM ubj)}(hjbd2_journal_aborth]j)}(hjbd2_journal_aborth]hjbd2_journal_abort}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj8hhhj 9hM ubjk)}(h(journal_t *journal, int errno)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj<9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj99ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj>9modnameN classnameNjj)}j]j)}jj9sbc.jbd2_journal_abortasbuh1hhj59ubj)}(h h]h }(hj\9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj59ubj)}(hjh]h*}(hjj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj59ubj)}(hjournalh]hjournal}(hjw9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj59ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj19ubjq)}(h int errnoh](j3)}(hinth]hint}(hj9hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(herrnoh]herrno}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj19ubeh}(h]h ]h"]h$]h&]jjuh1jjhj8hhhj 9hM ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj8hhhj 9hM ubah}(h]j8ah ](j j eh"]h$]h&]jj)jhuh1jhj 9hM hj8hhubj)}(hhh]h)}(h!Shutdown the journal immediately.h]h!Shutdown the journal immediately.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9hhubah}(h]h ]h"]h$]h&]uh1jhj8hhhj 9hM ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j9j4j9j5j6j7uh1jhhhjhNhNubj)}(hX**Parameters** ``journal_t *journal`` the journal to shutdown. ``int errno`` an error number to record in the journal indicating the reason for the shutdown. **Description** Perform a complete, immediate shutdown of the ENTIRE journal (not of a single transaction). This operation cannot be undone without closing and reopening the journal. The jbd2_journal_abort function is intended to support higher level error recovery mechanisms such as the ext2/ext3 remount-readonly error mode. Journal abort has very specific semantics. Any existing dirty, unjournaled buffers in the main filesystem will still be written to disk by bdflush, but the journaling mechanism will be suspended immediately and no further transaction commits will be honoured. Any dirty, journaled buffers will be written back to disk without hitting the journal. Atomicity cannot be guaranteed on an aborted filesystem, but we _do_ attempt to leave as much data as possible behind for fsck to use for cleanup. Any attempt to get a new transaction handle on a journal which is in ABORT state will just result in an -EROFS error return. A jbd2_journal_stop on an existing handle will return -EIO if we have entered abort state during the update. Recursive transactions are not disturbed by journal abort until the final jbd2_journal_stop, which will receive the -EIO error. Finally, the jbd2_journal_abort call allows the caller to supply an errno which will be recorded (if possible) in the journal superblock. This allows a client to record failure conditions in the middle of a transaction without having to complete the transaction to record the failure to disk. ext3_error, for example, now uses this functionality.h](h)}(h**Parameters**h]j=)}(hj9h]h Parameters}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj9ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubj)}(hhh](j)}(h0``journal_t *journal`` the journal to shutdown. h](j )}(h``journal_t *journal``h]j)}(hj:h]hjournal_t *journal}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj:ubj#)}(hhh]h)}(hthe journal to shutdown.h]hthe journal to shutdown.}(hj0:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,:hM hj-:ubah}(h]h ]h"]h$]h&]uh1j"hj:ubeh}(h]h ]h"]h$]h&]uh1jhj,:hM hj:ubj)}(h_``int errno`` an error number to record in the journal indicating the reason for the shutdown. h](j )}(h ``int errno``h]j)}(hjP:h]h int errno}(hjR:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjN:ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hjJ:ubj#)}(hhh]h)}(hPan error number to record in the journal indicating the reason for the shutdown.h]hPan error number to record in the journal indicating the reason for the shutdown.}(hji:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hjf:ubah}(h]h ]h"]h$]h&]uh1j"hjJ:ubeh}(h]h ]h"]h$]h&]uh1jhje:hM hj:ubeh}(h]h ]h"]h$]h&]uh1jhj9ubh)}(h**Description**h]j=)}(hj:h]h Description}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj:ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubh)}(hPerform a complete, immediate shutdown of the ENTIRE journal (not of a single transaction). This operation cannot be undone without closing and reopening the journal.h]hPerform a complete, immediate shutdown of the ENTIRE journal (not of a single transaction). This operation cannot be undone without closing and reopening the journal.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubh)}(hThe jbd2_journal_abort function is intended to support higher level error recovery mechanisms such as the ext2/ext3 remount-readonly error mode.h]hThe jbd2_journal_abort function is intended to support higher level error recovery mechanisms such as the ext2/ext3 remount-readonly error mode.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubh)}(hXJournal abort has very specific semantics. Any existing dirty, unjournaled buffers in the main filesystem will still be written to disk by bdflush, but the journaling mechanism will be suspended immediately and no further transaction commits will be honoured.h]hXJournal abort has very specific semantics. Any existing dirty, unjournaled buffers in the main filesystem will still be written to disk by bdflush, but the journaling mechanism will be suspended immediately and no further transaction commits will be honoured.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubh)}(hAny dirty, journaled buffers will be written back to disk without hitting the journal. Atomicity cannot be guaranteed on an aborted filesystem, but we _do_ attempt to leave as much data as possible behind for fsck to use for cleanup.h]hAny dirty, journaled buffers will be written back to disk without hitting the journal. Atomicity cannot be guaranteed on an aborted filesystem, but we _do_ attempt to leave as much data as possible behind for fsck to use for cleanup.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubh)}(hAny attempt to get a new transaction handle on a journal which is in ABORT state will just result in an -EROFS error return. A jbd2_journal_stop on an existing handle will return -EIO if we have entered abort state during the update.h]hAny attempt to get a new transaction handle on a journal which is in ABORT state will just result in an -EROFS error return. A jbd2_journal_stop on an existing handle will return -EIO if we have entered abort state during the update.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubh)}(hRecursive transactions are not disturbed by journal abort until the final jbd2_journal_stop, which will receive the -EIO error.h]hRecursive transactions are not disturbed by journal abort until the final jbd2_journal_stop, which will receive the -EIO error.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubh)}(hX\Finally, the jbd2_journal_abort call allows the caller to supply an errno which will be recorded (if possible) in the journal superblock. This allows a client to record failure conditions in the middle of a transaction without having to complete the transaction to record the failure to disk. ext3_error, for example, now uses this functionality.h]hX\Finally, the jbd2_journal_abort call allows the caller to supply an errno which will be recorded (if possible) in the journal superblock. This allows a client to record failure conditions in the middle of a transaction without having to complete the transaction to record the failure to disk. ext3_error, for example, now uses this functionality.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM hj9ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_journal_errno (C function)c.jbd2_journal_errnohNtauh1jhjhhhNhNubj)}(hhh](j)}(h+int jbd2_journal_errno (journal_t *journal)h]j)}(h*int jbd2_journal_errno(journal_t *journal)h](j3)}(hinth]hint}(hj+;hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj';hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM0 ubj)}(h h]h }(hj:;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj';hhhj9;hM0 ubj)}(hjbd2_journal_errnoh]j)}(hjbd2_journal_errnoh]hjbd2_journal_errno}(hjL;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH;ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj';hhhj9;hM0 ubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjk;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjh;ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjm;modnameN classnameNjj)}j]j)}jjN;sbc.jbd2_journal_errnoasbuh1hhjd;ubj)}(h h]h }(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd;ubj)}(hjh]h*}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd;ubj)}(hjournalh]hjournal}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjd;ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj`;ubah}(h]h ]h"]h$]h&]jjuh1jjhj';hhhj9;hM0 ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj#;hhhj9;hM0 ubah}(h]j;ah ](j j eh"]h$]h&]jj)jhuh1jhj9;hM0 hj ;hhubj)}(hhh]h)}(h"returns the journal's error state.h]h$returns the journal’s error state.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM0 hj;hhubah}(h]h ]h"]h$]h&]uh1jhj ;hhhj9;hM0 ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j;j4j;j5j6j7uh1jhhhjhNhNubj)}(hX<**Parameters** ``journal_t *journal`` journal to examine. **Description** This is the errno number set with jbd2_journal_abort(), the last time the journal was mounted - if the journal was stopped without calling abort this will be 0. If the journal has been aborted on this mount time -EROFS will be returned.h](h)}(h**Parameters**h]j=)}(hj;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj;ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM4 hj;ubj)}(hhh]j)}(h+``journal_t *journal`` journal to examine. h](j )}(h``journal_t *journal``h]j)}(hj<h]hjournal_t *journal}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM1 hj <ubj#)}(hhh]h)}(hjournal to examine.h]hjournal to examine.}(hj*<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&<hM1 hj'<ubah}(h]h ]h"]h$]h&]uh1j"hj <ubeh}(h]h ]h"]h$]h&]uh1jhj&<hM1 hj<ubah}(h]h ]h"]h$]h&]uh1jhj;ubh)}(h**Description**h]j=)}(hjL<h]h Description}(hjN<hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjJ<ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM3 hj;ubh)}(hThis is the errno number set with jbd2_journal_abort(), the last time the journal was mounted - if the journal was stopped without calling abort this will be 0.h]hThis is the errno number set with jbd2_journal_abort(), the last time the journal was mounted - if the journal was stopped without calling abort this will be 0.}(hjb<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM2 hj;ubh)}(hKIf the journal has been aborted on this mount time -EROFS will be returned.h]hKIf the journal has been aborted on this mount time -EROFS will be returned.}(hjq<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM6 hj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j#jbd2_journal_clear_err (C function)c.jbd2_journal_clear_errhNtauh1jhjhhhNhNubj)}(hhh](j)}(h/int jbd2_journal_clear_err (journal_t *journal)h]j)}(h.int jbd2_journal_clear_err(journal_t *journal)h](j3)}(hinth]hint}(hj<hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj<hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMH ubj)}(h h]h }(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<hhhj<hMH ubj)}(hjbd2_journal_clear_errh]j)}(hjbd2_journal_clear_errh]hjbd2_journal_clear_err}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj<hhhj<hMH ubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj<modnameN classnameNjj)}j]j)}jj<sbc.jbd2_journal_clear_errasbuh1hhj<ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(hjh]h*}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubj)}(hjournalh]hjournal}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj<ubah}(h]h ]h"]h$]h&]jjuh1jjhj<hhhj<hMH ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj<hhhj<hMH ubah}(h]j<ah ](j j eh"]h$]h&]jj)jhuh1jhj<hMH hj<hhubj)}(hhh]h)}(h clears the journal's error stateh]h"clears the journal’s error state}(hjE=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMH hjB=hhubah}(h]h ]h"]h$]h&]uh1jhj<hhhj<hMH ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j]=j4j]=j5j6j7uh1jhhhjhNhNubj)}(h**Parameters** ``journal_t *journal`` journal to act on. **Description** An error must be cleared or acked to take a FS out of readonly mode.h](h)}(h**Parameters**h]j=)}(hjg=h]h Parameters}(hji=hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hje=ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chML hja=ubj)}(hhh]j)}(h*``journal_t *journal`` journal to act on. h](j )}(h``journal_t *journal``h]j)}(hj=h]hjournal_t *journal}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMI hj=ubj#)}(hhh]h)}(hjournal to act on.h]hjournal to act on.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hMI hj=ubah}(h]h ]h"]h$]h&]uh1j"hj=ubeh}(h]h ]h"]h$]h&]uh1jhj=hMI hj}=ubah}(h]h ]h"]h$]h&]uh1jhja=ubh)}(h**Description**h]j=)}(hj=h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj=ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMK hja=ubh)}(hDAn error must be cleared or acked to take a FS out of readonly mode.h]hDAn error must be cleared or acked to take a FS out of readonly mode.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chMJ hja=ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!jbd2_journal_ack_err (C function)c.jbd2_journal_ack_errhNtauh1jhjhhhNhNubj)}(hhh](j)}(h.void jbd2_journal_ack_err (journal_t *journal)h]j)}(h-void jbd2_journal_ack_err(journal_t *journal)h](j3)}(hvoidh]hvoid}(hj>hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj>hhhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM\ ubj)}(h h]h }(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>hhhj>hM\ ubj)}(hjbd2_journal_ack_errh]j)}(hjbd2_journal_ack_errh]hjbd2_journal_ack_err}(hj'>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#>ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj>hhhj>hM\ ubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjF>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjC>ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjH>modnameN classnameNjj)}j]j)}jj)>sbc.jbd2_journal_ack_errasbuh1hhj?>ubj)}(h h]h }(hjf>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?>ubj)}(hjh]h*}(hjt>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?>ubj)}(hjournalh]hjournal}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?>ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj;>ubah}(h]h ]h"]h$]h&]jjuh1jjhj>hhhj>hM\ ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj=hhhj>hM\ ubah}(h]j=ah ](j j eh"]h$]h&]jj)jhuh1jhj>hM\ hj=hhubj)}(hhh]h)}(hAck journal err.h]hAck journal err.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM\ hj>hhubah}(h]h ]h"]h$]h&]uh1jhj=hhhj>hM\ ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j>j4j>j5j6j7uh1jhhhjhNhNubj)}(h**Parameters** ``journal_t *journal`` journal to act on. **Description** An error must be cleared or acked to take a FS out of readonly mode.h](h)}(h**Parameters**h]j=)}(hj>h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj>ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM` hj>ubj)}(hhh]j)}(h*``journal_t *journal`` journal to act on. h](j )}(h``journal_t *journal``h]j)}(hj>h]hjournal_t *journal}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM] hj>ubj#)}(hhh]h)}(hjournal to act on.h]hjournal to act on.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hM] hj?ubah}(h]h ]h"]h$]h&]uh1j"hj>ubeh}(h]h ]h"]h$]h&]uh1jhj?hM] hj>ubah}(h]h ]h"]h$]h&]uh1jhj>ubh)}(h**Description**h]j=)}(hj'?h]h Description}(hj)?hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj%?ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM_ hj>ubh)}(hDAn error must be cleared or acked to take a FS out of readonly mode.h]hDAn error must be cleared or acked to take a FS out of readonly mode.}(hj=?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:194: ./fs/jbd2/journal.chM^ hj>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!jbd2_journal_recover (C function)c.jbd2_journal_recoverhNtauh1jhjhhhNhNubj)}(hhh](j)}(h-int jbd2_journal_recover (journal_t *journal)h]j)}(h,int jbd2_journal_recover(journal_t *journal)h](j3)}(hinth]hint}(hjl?hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjh?hhh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chMubj)}(h h]h }(hj{?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjh?hhhjz?hMubj)}(hjbd2_journal_recoverh]j)}(hjbd2_journal_recoverh]hjbd2_journal_recover}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ](jjeh"]h$]h&]jjuh1jhjh?hhhjz?hMubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj?modnameN classnameNjj)}j]j)}jj?sbc.jbd2_journal_recoverasbuh1hhj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(hjh]h*}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubj)}(hjournalh]hjournal}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj?ubah}(h]h ]h"]h$]h&]jjuh1jjhjh?hhhjz?hMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjd?hhhjz?hMubah}(h]j_?ah ](j j eh"]h$]h&]jj)jhuh1jhjz?hMhja?hhubj)}(hhh]h)}(hrecovers a on-disk journalh]hrecovers a on-disk journal}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chMhj@hhubah}(h]h ]h"]h$]h&]uh1jhja?hhhjz?hMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j)@j4j)@j5j6j7uh1jhhhjhNhNubj)}(hX**Parameters** ``journal_t *journal`` the journal to recover **Description** The primary function for recovering the log contents when mounting a journaled device. Recovery is done in three passes. In the first pass, we look for the end of the log. In the second, we assemble the list of revoke blocks. In the third and final pass, we replay any un-revoked blocks in the log.h](h)}(h**Parameters**h]j=)}(hj3@h]h Parameters}(hj5@hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj1@ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chMhj-@ubj)}(hhh]j)}(h.``journal_t *journal`` the journal to recover h](j )}(h``journal_t *journal``h]j)}(hjR@h]hjournal_t *journal}(hjT@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjP@ubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chMhjL@ubj#)}(hhh]h)}(hthe journal to recoverh]hthe journal to recover}(hjk@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjg@hMhjh@ubah}(h]h ]h"]h$]h&]uh1j"hjL@ubeh}(h]h ]h"]h$]h&]uh1jhjg@hMhjI@ubah}(h]h ]h"]h$]h&]uh1jhj-@ubh)}(h**Description**h]j=)}(hj@h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj@ubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chMhj-@ubh)}(hVThe primary function for recovering the log contents when mounting a journaled device.h]hVThe primary function for recovering the log contents when mounting a journaled device.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chMhj-@ubh)}(hRecovery is done in three passes. In the first pass, we look for the end of the log. In the second, we assemble the list of revoke blocks. In the third and final pass, we replay any un-revoked blocks in the log.h]hRecovery is done in three passes. In the first pass, we look for the end of the log. In the second, we assemble the list of revoke blocks. In the third and final pass, we replay any un-revoked blocks in the log.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chMhj-@ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'jbd2_journal_skip_recovery (C function)c.jbd2_journal_skip_recoveryhNtauh1jhjhhhNhNubj)}(hhh](j)}(h3int jbd2_journal_skip_recovery (journal_t *journal)h]j)}(h2int jbd2_journal_skip_recovery(journal_t *journal)h](j3)}(hinth]hint}(hj@hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj@hhh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chM\ubj)}(h h]h }(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@hhhj@hM\ubj)}(hjbd2_journal_skip_recoveryh]j)}(hjbd2_journal_skip_recoveryh]hjbd2_journal_skip_recovery}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj@hhhj@hM\ubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj!AhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj#AmodnameN classnameNjj)}j]j)}jjAsbc.jbd2_journal_skip_recoveryasbuh1hhjAubj)}(h h]h }(hjAAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(hjh]h*}(hjOAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubj)}(hjournalh]hjournal}(hj\AhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjAubah}(h]h ]h"]h$]h&]jjuh1jjhj@hhhj@hM\ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj@hhhj@hM\ubah}(h]j@ah ](j j eh"]h$]h&]jj)jhuh1jhj@hM\hj@hhubj)}(hhh]h)}(h&Start journal and wipe exiting recordsh]h&Start journal and wipe exiting records}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chM\hjAhhubah}(h]h ]h"]h$]h&]uh1jhj@hhhj@hM\ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jAj4jAj5j6j7uh1jhhhjhNhNubj)}(hX**Parameters** ``journal_t *journal`` journal to startup **Description** Locate any valid recovery information from the journal and set up the journal structures in memory to ignore it (presumably because the caller has evidence that it is out of date). This function doesn't appear to be exported.. We perform one pass over the journal to allow us to tell the user how much recovery information is being erased, and to let us initialise the journal transaction sequence numbers to the next unused ID.h](h)}(h**Parameters**h]j=)}(hjAh]h Parameters}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjAubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chM`hjAubj)}(hhh]j)}(h*``journal_t *journal`` journal to startup h](j )}(h``journal_t *journal``h]j)}(hjAh]hjournal_t *journal}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chM]hjAubj#)}(hhh]h)}(hjournal to startuph]hjournal to startup}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjAhM]hjAubah}(h]h ]h"]h$]h&]uh1j"hjAubeh}(h]h ]h"]h$]h&]uh1jhjAhM]hjAubah}(h]h ]h"]h$]h&]uh1jhjAubh)}(h**Description**h]j=)}(hjBh]h Description}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjBubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chM_hjAubh)}(hLocate any valid recovery information from the journal and set up the journal structures in memory to ignore it (presumably because the caller has evidence that it is out of date). This function doesn't appear to be exported..h]hLocate any valid recovery information from the journal and set up the journal structures in memory to ignore it (presumably because the caller has evidence that it is out of date). This function doesn’t appear to be exported..}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chM^hjAubh)}(hWe perform one pass over the journal to allow us to tell the user how much recovery information is being erased, and to let us initialise the journal transaction sequence numbers to the next unused ID.h]hWe perform one pass over the journal to allow us to tell the user how much recovery information is being erased, and to let us initialise the journal transaction sequence numbers to the next unused ID.}(hj'BhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:197: ./fs/jbd2/recovery.chMchjAubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubeh}(h] journal-levelah ]h"] journal levelah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hTransaction Levelh]hTransaction Level}(hjHBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEBhhhhhKubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_journal_start (C function)c.jbd2_journal_starthNtauh1jhjEBhhhNhNubj)}(hhh](j)}(h?handle_t * jbd2_journal_start (journal_t *journal, int nblocks)h]j)}(h=handle_t *jbd2_journal_start(journal_t *journal, int nblocks)h](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjrBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjoBubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjtBmodnameN classnameNjj)}j]j)}jjbd2_journal_startsbc.jbd2_journal_startasbuh1hhjkBhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM ubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkBhhhjBhM ubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkBhhhjBhM ubj)}(hjbd2_journal_starth]j)}(hjBh]hjbd2_journal_start}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ](jjeh"]h$]h&]jjuh1jhjkBhhhjBhM ubjk)}(h!(journal_t *journal, int nblocks)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjBmodnameN classnameNjj)}j]jBc.jbd2_journal_startasbuh1hhjBubj)}(h h]h }(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hjh]h*}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubj)}(hjournalh]hjournal}(hj ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjBubjq)}(h int nblocksh](j3)}(hinth]hint}(hj#ChhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjCubj)}(h h]h }(hj1ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubj)}(hnblocksh]hnblocks}(hj?ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjBubeh}(h]h ]h"]h$]h&]jjuh1jjhjkBhhhjBhM ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjgBhhhjBhM ubah}(h]jbBah ](j j eh"]h$]h&]jj)jhuh1jhjBhM hjdBhhubj)}(hhh]h)}(hObtain a new handle.h]hObtain a new handle.}(hjiChhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjfChhubah}(h]h ]h"]h$]h&]uh1jhjdBhhhjBhM ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jCj4jCj5j6j7uh1jhhhjEBhNhNubj)}(hX**Parameters** ``journal_t *journal`` Journal to start transaction on. ``int nblocks`` number of block buffer we might modify **Description** We make sure that the transaction can guarantee at least nblocks of modified buffers in the log. We block until the log can guarantee that much space. Additionally, if rsv_blocks > 0, we also create another handle with rsv_blocks reserved blocks in the journal. This handle is stored in h_rsv_handle. It is not attached to any particular transaction and thus doesn't block transaction commit. If the caller uses this reserved handle, it has to set h_rsv_handle to NULL as otherwise jbd2_journal_stop() on the parent handle will dispose the reserved one. Reserved handle has to be converted to a normal handle using jbd2_journal_start_reserved() before it can be used. Return a pointer to a newly allocated handle, or an ERR_PTR() value on failure.h](h)}(h**Parameters**h]j=)}(hjCh]h Parameters}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjCubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjCubj)}(hhh](j)}(h8``journal_t *journal`` Journal to start transaction on. h](j )}(h``journal_t *journal``h]j)}(hjCh]hjournal_t *journal}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjCubj#)}(hhh]h)}(h Journal to start transaction on.h]h Journal to start transaction on.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChM hjCubah}(h]h ]h"]h$]h&]uh1j"hjCubeh}(h]h ]h"]h$]h&]uh1jhjChM hjCubj)}(h7``int nblocks`` number of block buffer we might modify h](j )}(h``int nblocks``h]j)}(hjCh]h int nblocks}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjCubj#)}(hhh]h)}(h&number of block buffer we might modifyh]h&number of block buffer we might modify}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChM hjCubah}(h]h ]h"]h$]h&]uh1j"hjCubeh}(h]h ]h"]h$]h&]uh1jhjChM hjCubeh}(h]h ]h"]h$]h&]uh1jhjCubh)}(h**Description**h]j=)}(hjDh]h Description}(hj DhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjDubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjCubh)}(hXWe make sure that the transaction can guarantee at least nblocks of modified buffers in the log. We block until the log can guarantee that much space. Additionally, if rsv_blocks > 0, we also create another handle with rsv_blocks reserved blocks in the journal. This handle is stored in h_rsv_handle. It is not attached to any particular transaction and thus doesn't block transaction commit. If the caller uses this reserved handle, it has to set h_rsv_handle to NULL as otherwise jbd2_journal_stop() on the parent handle will dispose the reserved one. Reserved handle has to be converted to a normal handle using jbd2_journal_start_reserved() before it can be used.h]hXWe make sure that the transaction can guarantee at least nblocks of modified buffers in the log. We block until the log can guarantee that much space. Additionally, if rsv_blocks > 0, we also create another handle with rsv_blocks reserved blocks in the journal. This handle is stored in h_rsv_handle. It is not attached to any particular transaction and thus doesn’t block transaction commit. If the caller uses this reserved handle, it has to set h_rsv_handle to NULL as otherwise jbd2_journal_stop() on the parent handle will dispose the reserved one. Reserved handle has to be converted to a normal handle using jbd2_journal_start_reserved() before it can be used.}(hj4DhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjCubh)}(hOReturn a pointer to a newly allocated handle, or an ERR_PTR() value on failure.h]hOReturn a pointer to a newly allocated handle, or an ERR_PTR() value on failure.}(hjCDhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjCubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(jbd2_journal_start_reserved (C function)c.jbd2_journal_start_reservedhNtauh1jhjEBhhhNhNubj)}(hhh](j)}(h[int jbd2_journal_start_reserved (handle_t *handle, unsigned int type, unsigned int line_no)h]j)}(hZint jbd2_journal_start_reserved(handle_t *handle, unsigned int type, unsigned int line_no)h](j3)}(hinth]hint}(hjrDhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjnDhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM8ubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnDhhhjDhM8ubj)}(hjbd2_journal_start_reservedh]j)}(hjbd2_journal_start_reservedh]hjbd2_journal_start_reserved}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ](jjeh"]h$]h&]jjuh1jhjnDhhhjDhM8ubjk)}(h;(handle_t *handle, unsigned int type, unsigned int line_no)h](jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjDmodnameN classnameNjj)}j]j)}jjDsbc.jbd2_journal_start_reservedasbuh1hhjDubj)}(h h]h }(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(hjh]h*}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubj)}(hhandleh]hhandle}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjDubjq)}(hunsigned int typeh](j3)}(hunsignedh]hunsigned}(hjEhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj3)}(hinth]hint}(hj"EhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjEubj)}(h h]h }(hj0EhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubj)}(htypeh]htype}(hj>EhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjDubjq)}(hunsigned int line_noh](j3)}(hunsignedh]hunsigned}(hjWEhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjSEubj)}(h h]h }(hjeEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSEubj3)}(hinth]hint}(hjsEhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjSEubj)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSEubj)}(hline_noh]hline_no}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSEubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjDubeh}(h]h ]h"]h$]h&]jjuh1jjhjnDhhhjDhM8ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjjDhhhjDhM8ubah}(h]jeDah ](j j eh"]h$]h&]jj)jhuh1jhjDhM8hjgDhhubj)}(hhh]h)}(hstart reserved handleh]hstart reserved handle}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM8hjEhhubah}(h]h ]h"]h$]h&]uh1jhjgDhhhjDhM8ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jEj4jEj5j6j7uh1jhhhjEBhNhNubj)}(hXM**Parameters** ``handle_t *handle`` handle to start ``unsigned int type`` for handle statistics ``unsigned int line_no`` for handle statistics **Description** Start handle that has been previously reserved with jbd2_journal_reserve(). This attaches **handle** to the running transaction (or creates one if there's not transaction running). Unlike jbd2_journal_start() this function cannot block on journal commit, checkpointing, or similar stuff. It can block on memory allocation or frozen journal though. Return 0 on success, non-zero on error - handle is freed in that case.h](h)}(h**Parameters**h]j=)}(hjEh]h Parameters}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjEubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM<hjEubj)}(hhh](j)}(h%``handle_t *handle`` handle to start h](j )}(h``handle_t *handle``h]j)}(hjEh]hhandle_t *handle}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM9hjEubj#)}(hhh]h)}(hhandle to starth]hhandle to start}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhM9hjFubah}(h]h ]h"]h$]h&]uh1j"hjEubeh}(h]h ]h"]h$]h&]uh1jhjFhM9hjEubj)}(h,``unsigned int type`` for handle statistics h](j )}(h``unsigned int type``h]j)}(hj3Fh]hunsigned int type}(hj5FhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1Fubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM:hj-Fubj#)}(hhh]h)}(hfor handle statisticsh]hfor handle statistics}(hjLFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHFhM:hjIFubah}(h]h ]h"]h$]h&]uh1j"hj-Fubeh}(h]h ]h"]h$]h&]uh1jhjHFhM:hjEubj)}(h/``unsigned int line_no`` for handle statistics h](j )}(h``unsigned int line_no``h]j)}(hjlFh]hunsigned int line_no}(hjnFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjjFubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM;hjfFubj#)}(hhh]h)}(hfor handle statisticsh]hfor handle statistics}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhM;hjFubah}(h]h ]h"]h$]h&]uh1j"hjfFubeh}(h]h ]h"]h$]h&]uh1jhjFhM;hjEubeh}(h]h ]h"]h$]h&]uh1jhjEubh)}(h**Description**h]j=)}(hjFh]h Description}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjFubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM=hjEubh)}(hX[Start handle that has been previously reserved with jbd2_journal_reserve(). This attaches **handle** to the running transaction (or creates one if there's not transaction running). Unlike jbd2_journal_start() this function cannot block on journal commit, checkpointing, or similar stuff. It can block on memory allocation or frozen journal though.h](hZStart handle that has been previously reserved with jbd2_journal_reserve(). This attaches }(hjFhhhNhNubj=)}(h **handle**h]hhandle}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjFubh to the running transaction (or creates one if there’s not transaction running). Unlike jbd2_journal_start() this function cannot block on journal commit, checkpointing, or similar stuff. It can block on memory allocation or frozen journal though.}(hjFhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM<hjEubh)}(hFReturn 0 on success, non-zero on error - handle is freed in that case.h]hFReturn 0 on success, non-zero on error - handle is freed in that case.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMBhjEubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j jbd2_journal_extend (C function)c.jbd2_journal_extendhNtauh1jhjEBhhhNhNubj)}(hhh](j)}(hKint jbd2_journal_extend (handle_t *handle, int nblocks, int revoke_records)h]j)}(hJint jbd2_journal_extend(handle_t *handle, int nblocks, int revoke_records)h](j3)}(hinth]hint}(hj GhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj Ghhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMnubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj GhhhjGhMnubj)}(hjbd2_journal_extendh]j)}(hjbd2_journal_extendh]hjbd2_journal_extend}(hj.GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*Gubah}(h]h ](jjeh"]h$]h&]jjuh1jhj GhhhjGhMnubjk)}(h3(handle_t *handle, int nblocks, int revoke_records)h](jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjMGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJGubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjOGmodnameN classnameNjj)}j]j)}jj0Gsbc.jbd2_journal_extendasbuh1hhjFGubj)}(h h]h }(hjmGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFGubj)}(hjh]h*}(hj{GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFGubj)}(hhandleh]hhandle}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFGubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjBGubjq)}(h int nblocksh](j3)}(hinth]hint}(hjGhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjGubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(hnblocksh]hnblocks}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjBGubjq)}(hint revoke_recordsh](j3)}(hinth]hint}(hjGhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjGubj)}(h h]h }(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubj)}(hrevoke_recordsh]hrevoke_records}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjBGubeh}(h]h ]h"]h$]h&]jjuh1jjhj GhhhjGhMnubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjGhhhjGhMnubah}(h]jGah ](j j eh"]h$]h&]jj)jhuh1jhjGhMnhjGhhubj)}(hhh]h)}(hextend buffer credits.h]hextend buffer credits.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMnhjHhhubah}(h]h ]h"]h$]h&]uh1jhjGhhhjGhMnubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j4Hj4j4Hj5j6j7uh1jhhhjEBhNhNubj)}(hX**Parameters** ``handle_t *handle`` handle to 'extend' ``int nblocks`` nr blocks to try to extend by. ``int revoke_records`` number of revoke records to try to extend by. **Description** Some transactions, such as large extends and truncates, can be done atomically all at once or in several stages. The operation requests a credit for a number of buffer modifications in advance, but can extend its credit if it needs more. jbd2_journal_extend tries to give the running handle more buffer credits. It does not guarantee that allocation - this is a best-effort only. The calling process MUST be able to deal cleanly with a failure to extend here. Return 0 on success, non-zero on failure. return code < 0 implies an error return code > 0 implies normal transaction-full status.h](h)}(h**Parameters**h]j=)}(hj>Hh]h Parameters}(hj@HhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM|hj8Hubh)}(hXreturn code < 0 implies an error return code > 0 implies normal transaction-full status.h]hXreturn code < 0 implies an error return code > 0 implies normal transaction-full status.}(hjMIhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM~hj8Hubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"jbd2__journal_restart (C function)c.jbd2__journal_restarthNtauh1jhjEBhhhNhNubj)}(hhh](j)}(h]int jbd2__journal_restart (handle_t *handle, int nblocks, int revoke_records, gfp_t gfp_mask)h]j)}(h\int jbd2__journal_restart(handle_t *handle, int nblocks, int revoke_records, gfp_t gfp_mask)h](j3)}(hinth]hint}(hj|IhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjxIhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxIhhhjIhMubj)}(hjbd2__journal_restarth]j)}(hjbd2__journal_restarth]hjbd2__journal_restart}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ](jjeh"]h$]h&]jjuh1jhjxIhhhjIhMubjk)}(hC(handle_t *handle, int nblocks, int revoke_records, gfp_t gfp_mask)h](jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjImodnameN classnameNjj)}j]j)}jjIsbc.jbd2__journal_restartasbuh1hhjIubj)}(h h]h }(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(hjh]h*}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubj)}(hhandleh]hhandle}(hjIhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjIubjq)}(h int nblocksh](j3)}(hinth]hint}(hjJhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj Jubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Jubj)}(hnblocksh]hnblocks}(hj,JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Jubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjIubjq)}(hint revoke_recordsh](j3)}(hinth]hint}(hjEJhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjAJubj)}(h h]h }(hjSJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAJubj)}(hrevoke_recordsh]hrevoke_records}(hjaJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAJubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjIubjq)}(hgfp_t gfp_maskh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj}JhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzJubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjJmodnameN classnameNjj)}j]jIc.jbd2__journal_restartasbuh1hhjvJubj)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvJubj)}(hgfp_maskh]hgfp_mask}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvJubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjIubeh}(h]h ]h"]h$]h&]jjuh1jjhjxIhhhjIhMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjtIhhhjIhMubah}(h]joIah ](j j eh"]h$]h&]jj)jhuh1jhjIhMhjqIhhubj)}(hhh]h)}(hrestart a handle .h]hrestart a handle .}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjJhhubah}(h]h ]h"]h$]h&]uh1jhjqIhhhjIhMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jJj4jJj5j6j7uh1jhhhjEBhNhNubj)}(hX**Parameters** ``handle_t *handle`` handle to restart ``int nblocks`` nr credits requested ``int revoke_records`` number of revoke record credits requested ``gfp_t gfp_mask`` memory allocation flags (for start_this_handle) **Description** Restart a handle for a multi-transaction filesystem operation. If the jbd2_journal_extend() call above fails to grant new buffer credits to a running handle, a call to jbd2_journal_restart will commit the handle's transaction so far and reattach the handle to a new transaction capable of guaranteeing the requested number of credits. We preserve reserved handle if there's any attached to the passed in handle.h](h)}(h**Parameters**h]j=)}(hjJh]h Parameters}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjJubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjJubj)}(hhh](j)}(h'``handle_t *handle`` handle to restart h](j )}(h``handle_t *handle``h]j)}(hjKh]hhandle_t *handle}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjKubj#)}(hhh]h)}(hhandle to restarth]hhandle to restart}(hj-KhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)KhMhj*Kubah}(h]h ]h"]h$]h&]uh1j"hjKubeh}(h]h ]h"]h$]h&]uh1jhj)KhMhj Kubj)}(h%``int nblocks`` nr credits requested h](j )}(h``int nblocks``h]j)}(hjMKh]h int nblocks}(hjOKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKKubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjGKubj#)}(hhh]h)}(hnr credits requestedh]hnr credits requested}(hjfKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbKhMhjcKubah}(h]h ]h"]h$]h&]uh1j"hjGKubeh}(h]h ]h"]h$]h&]uh1jhjbKhMhj Kubj)}(hA``int revoke_records`` number of revoke record credits requested h](j )}(h``int revoke_records``h]j)}(hjKh]hint revoke_records}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjKubj#)}(hhh]h)}(h)number of revoke record credits requestedh]h)number of revoke record credits requested}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhMhjKubah}(h]h ]h"]h$]h&]uh1j"hjKubeh}(h]h ]h"]h$]h&]uh1jhjKhMhj Kubj)}(hC``gfp_t gfp_mask`` memory allocation flags (for start_this_handle) h](j )}(h``gfp_t gfp_mask``h]j)}(hjKh]hgfp_t gfp_mask}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjKubj#)}(hhh]h)}(h/memory allocation flags (for start_this_handle)h]h/memory allocation flags (for start_this_handle)}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhMhjKubah}(h]h ]h"]h$]h&]uh1j"hjKubeh}(h]h ]h"]h$]h&]uh1jhjKhMhj Kubeh}(h]h ]h"]h$]h&]uh1jhjJubh)}(h**Description**h]j=)}(hjKh]h Description}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjKubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjJubh)}(h>Restart a handle for a multi-transaction filesystem operation.h]h>Restart a handle for a multi-transaction filesystem operation.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjJubh)}(hX\If the jbd2_journal_extend() call above fails to grant new buffer credits to a running handle, a call to jbd2_journal_restart will commit the handle's transaction so far and reattach the handle to a new transaction capable of guaranteeing the requested number of credits. We preserve reserved handle if there's any attached to the passed in handle.h]hX`If the jbd2_journal_extend() call above fails to grant new buffer credits to a running handle, a call to jbd2_journal_restart will commit the handle’s transaction so far and reattach the handle to a new transaction capable of guaranteeing the requested number of credits. We preserve reserved handle if there’s any attached to the passed in handle.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjJubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&jbd2_journal_lock_updates (C function)c.jbd2_journal_lock_updateshNtauh1jhjEBhhhNhNubj)}(hhh](j)}(h3void jbd2_journal_lock_updates (journal_t *journal)h]j)}(h2void jbd2_journal_lock_updates(journal_t *journal)h](j3)}(hvoidh]hvoid}(hjNLhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjJLhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMSubj)}(h h]h }(hj]LhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJLhhhj\LhMSubj)}(hjbd2_journal_lock_updatesh]j)}(hjbd2_journal_lock_updatesh]hjbd2_journal_lock_updates}(hjoLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkLubah}(h]h ](jjeh"]h$]h&]jjuh1jhjJLhhhj\LhMSubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjLmodnameN classnameNjj)}j]j)}jjqLsbc.jbd2_journal_lock_updatesasbuh1hhjLubj)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(hjh]h*}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(hjournalh]hjournal}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjLubah}(h]h ]h"]h$]h&]jjuh1jjhjJLhhhj\LhMSubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjFLhhhj\LhMSubah}(h]jALah ](j j eh"]h$]h&]jj)jhuh1jhj\LhMShjCLhhubj)}(hhh]h)}(h establish a transaction barrier.h]h establish a transaction barrier.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMShjLhhubah}(h]h ]h"]h$]h&]uh1jhjCLhhhj\LhMSubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j Mj4j Mj5j6j7uh1jhhhjEBhNhNubj)}(hXJ**Parameters** ``journal_t *journal`` Journal to establish a barrier on. **Description** This locks out any further updates from being started, and blocks until all existing updates have completed, returning only once the journal is in a quiescent state with no updates running. The journal lock should not be held on entry.h](h)}(h**Parameters**h]j=)}(hjMh]h Parameters}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjMubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMWhjMubj)}(hhh]j)}(h:``journal_t *journal`` Journal to establish a barrier on. h](j )}(h``journal_t *journal``h]j)}(hj4Mh]hjournal_t *journal}(hj6MhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2Mubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMThj.Mubj#)}(hhh]h)}(h"Journal to establish a barrier on.h]h"Journal to establish a barrier on.}(hjMMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIMhMThjJMubah}(h]h ]h"]h$]h&]uh1j"hj.Mubeh}(h]h ]h"]h$]h&]uh1jhjIMhMThj+Mubah}(h]h ]h"]h$]h&]uh1jhjMubh)}(h**Description**h]j=)}(hjoMh]h Description}(hjqMhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjmMubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMVhjMubh)}(hThis locks out any further updates from being started, and blocks until all existing updates have completed, returning only once the journal is in a quiescent state with no updates running.h]hThis locks out any further updates from being started, and blocks until all existing updates have completed, returning only once the journal is in a quiescent state with no updates running.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMUhjMubh)}(h-The journal lock should not be held on entry.h]h-The journal lock should not be held on entry.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMYhjMubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(jbd2_journal_unlock_updates (C function)c.jbd2_journal_unlock_updateshNtauh1jhjEBhhhNhNubj)}(hhh](j)}(h5void jbd2_journal_unlock_updates (journal_t *journal)h]j)}(h4void jbd2_journal_unlock_updates(journal_t *journal)h](j3)}(hvoidh]hvoid}(hjMhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjMhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMzubj)}(h h]h }(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMhhhjMhMzubj)}(hjbd2_journal_unlock_updatesh]j)}(hjbd2_journal_unlock_updatesh]hjbd2_journal_unlock_updates}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubah}(h]h ](jjeh"]h$]h&]jjuh1jhjMhhhjMhMzubjk)}(h(journal_t *journal)h]jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjNmodnameN classnameNjj)}j]j)}jjMsbc.jbd2_journal_unlock_updatesasbuh1hhjMubj)}(h h]h }(hj#NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(hjh]h*}(hj1NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubj)}(hjournalh]hjournal}(hj>NhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjMubah}(h]h ]h"]h$]h&]jjuh1jjhjMhhhjMhMzubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjMhhhjMhMzubah}(h]jMah ](j j eh"]h$]h&]jj)jhuh1jhjMhMzhjMhhubj)}(hhh]h)}(hrelease barrierh]hrelease barrier}(hjhNhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMzhjeNhhubah}(h]h ]h"]h$]h&]uh1jhjMhhhjMhMzubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jNj4jNj5j6j7uh1jhhhjEBhNhNubj)}(h**Parameters** ``journal_t *journal`` Journal to release the barrier on. **Description** Release a transaction barrier obtained with jbd2_journal_lock_updates(). Should be called without the journal lock held.h](h)}(h**Parameters**h]j=)}(hjNh]h Parameters}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM~hjNubj)}(hhh]j)}(h:``journal_t *journal`` Journal to release the barrier on. h](j )}(h``journal_t *journal``h]j)}(hjNh]hjournal_t *journal}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM{hjNubj#)}(hhh]h)}(h"Journal to release the barrier on.h]h"Journal to release the barrier on.}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhM{hjNubah}(h]h ]h"]h$]h&]uh1j"hjNubeh}(h]h ]h"]h$]h&]uh1jhjNhM{hjNubah}(h]h ]h"]h$]h&]uh1jhjNubh)}(h**Description**h]j=)}(hjNh]h Description}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM}hjNubh)}(hHRelease a transaction barrier obtained with jbd2_journal_lock_updates().h]hHRelease a transaction barrier obtained with jbd2_journal_lock_updates().}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM|hjNubh)}(h/Should be called without the journal lock held.h]h/Should be called without the journal lock held.}(hj OhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM~hjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j*jbd2_journal_get_write_access (C function)c.jbd2_journal_get_write_accesshNtauh1jhjEBhhhNhNubj)}(hhh](j)}(hLint jbd2_journal_get_write_access (handle_t *handle, struct buffer_head *bh)h]j)}(hKint jbd2_journal_get_write_access(handle_t *handle, struct buffer_head *bh)h](j3)}(hinth]hint}(hj8OhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj4Ohhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMubj)}(h h]h }(hjGOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj4OhhhjFOhMubj)}(hjbd2_journal_get_write_accessh]j)}(hjbd2_journal_get_write_accessh]hjbd2_journal_get_write_access}(hjYOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUOubah}(h]h ](jjeh"]h$]h&]jjuh1jhj4OhhhjFOhMubjk)}(h*(handle_t *handle, struct buffer_head *bh)h](jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjxOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuOubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjzOmodnameN classnameNjj)}j]j)}jj[Osbc.jbd2_journal_get_write_accessasbuh1hhjqOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqOubj)}(hjh]h*}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqOubj)}(hhandleh]hhandle}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqOubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjmOubjq)}(hstruct buffer_head *bhh](j)}(hjVh]hstruct}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubh)}(hhh]j)}(h buffer_headh]h buffer_head}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjOmodnameN classnameNjj)}j]jOc.jbd2_journal_get_write_accessasbuh1hhjOubj)}(h h]h }(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj)}(hjh]h*}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj)}(hbhh]hbh}(hj#PhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjmOubeh}(h]h ]h"]h$]h&]jjuh1jjhj4OhhhjFOhMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj0OhhhjFOhMubah}(h]j+Oah ](j j eh"]h$]h&]jj)jhuh1jhjFOhMhj-Ohhubj)}(hhh]h)}(h@notify intent to modify a buffer for metadata (not data) update.h]h@notify intent to modify a buffer for metadata (not data) update.}(hjMPhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjJPhhubah}(h]h ]h"]h$]h&]uh1jhj-OhhhjFOhMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jePj4jePj5j6j7uh1jhhhjEBhNhNubj)}(hX`**Parameters** ``handle_t *handle`` transaction to add buffer modifications to ``struct buffer_head *bh`` bh to be used for metadata writes **Return** error code or 0 on success. **Description** In full data journalling mode the buffer may be of type BJ_AsyncData, because we're ``write()ing`` a buffer which is also part of a shared mapping.h](h)}(h**Parameters**h]j=)}(hjoPh]h Parameters}(hjqPhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjmPubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjiPubj)}(hhh](j)}(h@``handle_t *handle`` transaction to add buffer modifications to h](j )}(h``handle_t *handle``h]j)}(hjPh]hhandle_t *handle}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjPubj#)}(hhh]h)}(h*transaction to add buffer modifications toh]h*transaction to add buffer modifications to}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMhjPubah}(h]h ]h"]h$]h&]uh1j"hjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjPubj)}(h=``struct buffer_head *bh`` bh to be used for metadata writes h](j )}(h``struct buffer_head *bh``h]j)}(hjPh]hstruct buffer_head *bh}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjPubj#)}(hhh]h)}(h!bh to be used for metadata writesh]h!bh to be used for metadata writes}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMhjPubah}(h]h ]h"]h$]h&]uh1j"hjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjPubeh}(h]h ]h"]h$]h&]uh1jhjiPubh)}(h **Return**h]j=)}(hjQh]hReturn}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjQubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjiPubh)}(herror code or 0 on success.h]herror code or 0 on success.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjiPubh)}(h**Description**h]j=)}(hj)Qh]h Description}(hj+QhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj'Qubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjiPubh)}(hIn full data journalling mode the buffer may be of type BJ_AsyncData, because we're ``write()ing`` a buffer which is also part of a shared mapping.h](hVIn full data journalling mode the buffer may be of type BJ_AsyncData, because we’re }(hj?QhhhNhNubj)}(h``write()ing``h]h write()ing}(hjGQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?Qubh1 a buffer which is also part of a shared mapping.}(hj?QhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjiPubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j+jbd2_journal_get_create_access (C function) c.jbd2_journal_get_create_accesshNtauh1jhjEBhhhNhNubj)}(hhh](j)}(hMint jbd2_journal_get_create_access (handle_t *handle, struct buffer_head *bh)h]j)}(hLint jbd2_journal_get_create_access(handle_t *handle, struct buffer_head *bh)h](j3)}(hinth]hint}(hjQhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj|Qhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|QhhhjQhMubj)}(hjbd2_journal_get_create_accessh]j)}(hjbd2_journal_get_create_accessh]hjbd2_journal_get_create_access}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ](jjeh"]h$]h&]jjuh1jhj|QhhhjQhMubjk)}(h*(handle_t *handle, struct buffer_head *bh)h](jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjQmodnameN classnameNjj)}j]j)}jjQsb c.jbd2_journal_get_create_accessasbuh1hhjQubj)}(h h]h }(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubj)}(hjh]h*}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubj)}(hhandleh]hhandle}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjQubjq)}(hstruct buffer_head *bhh](j)}(hjVh]hstruct}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(h h]h }(hj!RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubh)}(hhh]j)}(h buffer_headh]h buffer_head}(hj2RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/Rubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj4RmodnameN classnameNjj)}j]jQ c.jbd2_journal_get_create_accessasbuh1hhjRubj)}(h h]h }(hjPRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hjh]h*}(hj^RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubj)}(hbhh]hbh}(hjkRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjQubeh}(h]h ]h"]h$]h&]jjuh1jjhj|QhhhjQhMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjxQhhhjQhMubah}(h]jsQah ](j j eh"]h$]h&]jj)jhuh1jhjQhMhjuQhhubj)}(hhh]h)}(h%notify intent to use newly created bhh]h%notify intent to use newly created bh}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjRhhubah}(h]h ]h"]h$]h&]uh1jhjuQhhhjQhMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jRj4jRj5j6j7uh1jhhhjEBhNhNubj)}(h**Parameters** ``handle_t *handle`` transaction to new buffer to ``struct buffer_head *bh`` new buffer. **Description** Call this if you create a new bh.h](h)}(h**Parameters**h]j=)}(hjRh]h Parameters}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjRubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjRubj)}(hhh](j)}(h2``handle_t *handle`` transaction to new buffer to h](j )}(h``handle_t *handle``h]j)}(hjRh]hhandle_t *handle}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjRubj#)}(hhh]h)}(htransaction to new buffer toh]htransaction to new buffer to}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjRhMhjRubah}(h]h ]h"]h$]h&]uh1j"hjRubeh}(h]h ]h"]h$]h&]uh1jhjRhMhjRubj)}(h'``struct buffer_head *bh`` new buffer. h](j )}(h``struct buffer_head *bh``h]j)}(hjSh]hstruct buffer_head *bh}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhj Subah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj Subj#)}(hhh]h)}(h new buffer.h]h new buffer.}(hj(ShhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$ShMhj%Subah}(h]h ]h"]h$]h&]uh1j"hj Subeh}(h]h ]h"]h$]h&]uh1jhj$ShMhjRubeh}(h]h ]h"]h$]h&]uh1jhjRubh)}(h**Description**h]j=)}(hjJSh]h Description}(hjLShhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjHSubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjRubh)}(h!Call this if you create a new bh.h]h!Call this if you create a new bh.}(hj`ShhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjRubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j)jbd2_journal_get_undo_access (C function)c.jbd2_journal_get_undo_accesshNtauh1jhjEBhhhNhNubj)}(hhh](j)}(hKint jbd2_journal_get_undo_access (handle_t *handle, struct buffer_head *bh)h]j)}(hJint jbd2_journal_get_undo_access(handle_t *handle, struct buffer_head *bh)h](j3)}(hinth]hint}(hjShhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjShhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM`ubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjShhhjShM`ubj)}(hjbd2_journal_get_undo_accessh]j)}(hjbd2_journal_get_undo_accessh]hjbd2_journal_get_undo_access}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ](jjeh"]h$]h&]jjuh1jhjShhhjShM`ubjk)}(h*(handle_t *handle, struct buffer_head *bh)h](jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjSmodnameN classnameNjj)}j]j)}jjSsbc.jbd2_journal_get_undo_accessasbuh1hhjSubj)}(h h]h }(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(hjh]h*}(hjShhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj)}(hhandleh]hhandle}(hj ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjSubjq)}(hstruct buffer_head *bhh](j)}(hjVh]hstruct}(hj#ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(h h]h }(hj0ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubh)}(hhh]j)}(h buffer_headh]h buffer_head}(hjAThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>Tubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjCTmodnameN classnameNjj)}j]jSc.jbd2_journal_get_undo_accessasbuh1hhjTubj)}(h h]h }(hj_ThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(hjh]h*}(hjmThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubj)}(hbhh]hbh}(hjzThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjSubeh}(h]h ]h"]h$]h&]jjuh1jjhjShhhjShM`ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjShhhjShM`ubah}(h]jSah ](j j eh"]h$]h&]jj)jhuh1jhjShM`hjShhubj)}(hhh]h)}(hANotify intent to modify metadata with non-rewindable consequencesh]hANotify intent to modify metadata with non-rewindable consequences}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM`hjThhubah}(h]h ]h"]h$]h&]uh1jhjShhhjShM`ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jTj4jTj5j6j7uh1jhhhjEBhNhNubj)}(hXS**Parameters** ``handle_t *handle`` transaction ``struct buffer_head *bh`` buffer to undo **Description** Sometimes there is a need to distinguish between metadata which has been committed to disk and that which has not. The ext3fs code uses this for freeing and allocating space, we have to make sure that we do not reuse freed space until the deallocation has been committed, since if we overwrote that space we would make the delete un-rewindable in case of a crash. To deal with that, jbd2_journal_get_undo_access requests write access to a buffer for parts of non-rewindable operations such as delete operations on the bitmaps. The journaling code must keep a copy of the buffer's contents prior to the undo_access call until such time as we know that the buffer has definitely been committed to disk. We never need to know which transaction the committed data is part of, buffers touched here are guaranteed to be dirtied later and so will be committed to a new transaction in due course, at which point we can discard the old committed data pointer. Returns error number or 0 on success.h](h)}(h**Parameters**h]j=)}(hjTh]h Parameters}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjTubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMdhjTubj)}(hhh](j)}(h!``handle_t *handle`` transaction h](j )}(h``handle_t *handle``h]j)}(hjTh]hhandle_t *handle}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMbhjTubj#)}(hhh]h)}(h transactionh]h transaction}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThMbhjTubah}(h]h ]h"]h$]h&]uh1j"hjTubeh}(h]h ]h"]h$]h&]uh1jhjThMbhjTubj)}(h*``struct buffer_head *bh`` buffer to undo h](j )}(h``struct buffer_head *bh``h]j)}(hjUh]hstruct buffer_head *bh}(hj UhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMchjUubj#)}(hhh]h)}(hbuffer to undoh]hbuffer to undo}(hj7UhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3UhMchj4Uubah}(h]h ]h"]h$]h&]uh1j"hjUubeh}(h]h ]h"]h$]h&]uh1jhj3UhMchjTubeh}(h]h ]h"]h$]h&]uh1jhjTubh)}(h**Description**h]j=)}(hjYUh]h Description}(hj[UhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjWUubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMehjTubh)}(hXlSometimes there is a need to distinguish between metadata which has been committed to disk and that which has not. The ext3fs code uses this for freeing and allocating space, we have to make sure that we do not reuse freed space until the deallocation has been committed, since if we overwrote that space we would make the delete un-rewindable in case of a crash.h]hXlSometimes there is a need to distinguish between metadata which has been committed to disk and that which has not. The ext3fs code uses this for freeing and allocating space, we have to make sure that we do not reuse freed space until the deallocation has been committed, since if we overwrote that space we would make the delete un-rewindable in case of a crash.}(hjoUhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMdhjTubh)}(hXQTo deal with that, jbd2_journal_get_undo_access requests write access to a buffer for parts of non-rewindable operations such as delete operations on the bitmaps. The journaling code must keep a copy of the buffer's contents prior to the undo_access call until such time as we know that the buffer has definitely been committed to disk.h]hXSTo deal with that, jbd2_journal_get_undo_access requests write access to a buffer for parts of non-rewindable operations such as delete operations on the bitmaps. The journaling code must keep a copy of the buffer’s contents prior to the undo_access call until such time as we know that the buffer has definitely been committed to disk.}(hj~UhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMkhjTubh)}(hWe never need to know which transaction the committed data is part of, buffers touched here are guaranteed to be dirtied later and so will be committed to a new transaction in due course, at which point we can discard the old committed data pointer.h]hWe never need to know which transaction the committed data is part of, buffers touched here are guaranteed to be dirtied later and so will be committed to a new transaction in due course, at which point we can discard the old committed data pointer.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMqhjTubh)}(h%Returns error number or 0 on success.h]h%Returns error number or 0 on success.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMvhjTubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&jbd2_journal_set_triggers (C function)c.jbd2_journal_set_triggershNtauh1jhjEBhhhNhNubj)}(hhh](j)}(h^void jbd2_journal_set_triggers (struct buffer_head *bh, struct jbd2_buffer_trigger_type *type)h]j)}(h]void jbd2_journal_set_triggers(struct buffer_head *bh, struct jbd2_buffer_trigger_type *type)h](j3)}(hvoidh]hvoid}(hjUhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjUhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMubj)}(h h]h }(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUhhhjUhMubj)}(hjbd2_journal_set_triggersh]j)}(hjbd2_journal_set_triggersh]hjbd2_journal_set_triggers}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ](jjeh"]h$]h&]jjuh1jhjUhhhjUhMubjk)}(h?(struct buffer_head *bh, struct jbd2_buffer_trigger_type *type)h](jq)}(hstruct buffer_head *bhh](j)}(hjVh]hstruct}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubh)}(hhh]j)}(h buffer_headh]h buffer_head}(hj&VhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#Vubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj(VmodnameN classnameNjj)}j]j)}jjUsbc.jbd2_journal_set_triggersasbuh1hhjVubj)}(h h]h }(hjFVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(hjh]h*}(hjTVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(hbhh]hbh}(hjaVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjVubjq)}(h%struct jbd2_buffer_trigger_type *typeh](j)}(hjVh]hstruct}(hjzVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvVubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvVubh)}(hhh]j)}(hjbd2_buffer_trigger_typeh]hjbd2_buffer_trigger_type}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjVmodnameN classnameNjj)}j]jBVc.jbd2_journal_set_triggersasbuh1hhjvVubj)}(h h]h }(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvVubj)}(hjh]h*}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvVubj)}(htypeh]htype}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvVubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjVubeh}(h]h ]h"]h$]h&]jjuh1jjhjUhhhjUhMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjUhhhjUhMubah}(h]jUah ](j j eh"]h$]h&]jj)jhuh1jhjUhMhjUhhubj)}(hhh]h)}(h Add triggers for commit writeouth]h Add triggers for commit writeout}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjVhhubah}(h]h ]h"]h$]h&]uh1jhjUhhhjUhMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jWj4jWj5j6j7uh1jhhhjEBhNhNubj)}(hX**Parameters** ``struct buffer_head *bh`` buffer to trigger on ``struct jbd2_buffer_trigger_type *type`` struct jbd2_buffer_trigger_type containing the trigger(s). **Description** Set any triggers on this journal_head. This is always safe, because triggers for a committing buffer will be saved off, and triggers for a running transaction will match the buffer in that transaction. Call with NULL to clear the triggers.h](h)}(h**Parameters**h]j=)}(hjWh]h Parameters}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjWubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjWubj)}(hhh](j)}(h0``struct buffer_head *bh`` buffer to trigger on h](j )}(h``struct buffer_head *bh``h]j)}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:Wubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj6Wubj#)}(hhh]h)}(hbuffer to trigger onh]hbuffer to trigger on}(hjUWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjQWhMhjRWubah}(h]h ]h"]h$]h&]uh1j"hj6Wubeh}(h]h ]h"]h$]h&]uh1jhjQWhMhj3Wubj)}(he``struct jbd2_buffer_trigger_type *type`` struct jbd2_buffer_trigger_type containing the trigger(s). h](j )}(h)``struct jbd2_buffer_trigger_type *type``h]j)}(hjuWh]h%struct jbd2_buffer_trigger_type *type}(hjwWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsWubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjoWubj#)}(hhh]h)}(h:struct jbd2_buffer_trigger_type containing the trigger(s).h]h:struct jbd2_buffer_trigger_type containing the trigger(s).}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhMhjWubah}(h]h ]h"]h$]h&]uh1j"hjoWubeh}(h]h ]h"]h$]h&]uh1jhjWhMhj3Wubeh}(h]h ]h"]h$]h&]uh1jhjWubh)}(h**Description**h]j=)}(hjWh]h Description}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjWubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjWubh)}(hSet any triggers on this journal_head. This is always safe, because triggers for a committing buffer will be saved off, and triggers for a running transaction will match the buffer in that transaction.h]hSet any triggers on this journal_head. This is always safe, because triggers for a committing buffer will be saved off, and triggers for a running transaction will match the buffer in that transaction.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjWubh)}(h%Call with NULL to clear the triggers.h]h%Call with NULL to clear the triggers.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjWubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(jbd2_journal_dirty_metadata (C function)c.jbd2_journal_dirty_metadatahNtauh1jhjEBhhhNhNubj)}(hhh](j)}(hJint jbd2_journal_dirty_metadata (handle_t *handle, struct buffer_head *bh)h]j)}(hIint jbd2_journal_dirty_metadata(handle_t *handle, struct buffer_head *bh)h](j3)}(hinth]hint}(hjXhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjXhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXhhhjXhMubj)}(hjbd2_journal_dirty_metadatah]j)}(hjbd2_journal_dirty_metadatah]hjbd2_journal_dirty_metadata}(hj%XhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!Xubah}(h]h ](jjeh"]h$]h&]jjuh1jhjXhhhjXhMubjk)}(h*(handle_t *handle, struct buffer_head *bh)h](jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjDXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAXubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjFXmodnameN classnameNjj)}j]j)}jj'Xsbc.jbd2_journal_dirty_metadataasbuh1hhj=Xubj)}(h h]h }(hjdXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=Xubj)}(hjh]h*}(hjrXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=Xubj)}(hhandleh]hhandle}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=Xubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj9Xubjq)}(hstruct buffer_head *bhh](j)}(hjVh]hstruct}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubh)}(hhh]j)}(h buffer_headh]h buffer_head}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjXmodnameN classnameNjj)}j]j`Xc.jbd2_journal_dirty_metadataasbuh1hhjXubj)}(h h]h }(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hjh]h*}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubj)}(hbhh]hbh}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj9Xubeh}(h]h ]h"]h$]h&]jjuh1jjhjXhhhjXhMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjWhhhjXhMubah}(h]jWah ](j j eh"]h$]h&]jj)jhuh1jhjXhMhjWhhubj)}(hhh]h)}(h*mark a buffer as containing dirty metadatah]h*mark a buffer as containing dirty metadata}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjYhhubah}(h]h ]h"]h$]h&]uh1jhjWhhhjXhMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j1Yj4j1Yj5j6j7uh1jhhhjEBhNhNubj)}(hX**Parameters** ``handle_t *handle`` transaction to add buffer to. ``struct buffer_head *bh`` buffer to mark **Description** mark dirty metadata which needs to be journaled as part of the current transaction. The buffer must have previously had jbd2_journal_get_write_access() called so that it has a valid journal_head attached to the buffer head. The buffer is placed on the transaction's metadata list and is marked as belonging to the transaction. Returns error number or 0 on success. Special care needs to be taken if the buffer already belongs to the current committing transaction (in which case we should have frozen data present for that commit). In that case, we don't relink the buffer: that only gets done when the old transaction finally completes its commit.h](h)}(h**Parameters**h]j=)}(hj;Yh]h Parameters}(hj=YhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj9Yubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj5Yubj)}(hhh](j)}(h3``handle_t *handle`` transaction to add buffer to. h](j )}(h``handle_t *handle``h]j)}(hjZYh]hhandle_t *handle}(hj\YhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXYubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjTYubj#)}(hhh]h)}(htransaction to add buffer to.h]htransaction to add buffer to.}(hjsYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjoYhMhjpYubah}(h]h ]h"]h$]h&]uh1j"hjTYubeh}(h]h ]h"]h$]h&]uh1jhjoYhMhjQYubj)}(h*``struct buffer_head *bh`` buffer to mark h](j )}(h``struct buffer_head *bh``h]j)}(hjYh]hstruct buffer_head *bh}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhjYubj#)}(hhh]h)}(hbuffer to markh]hbuffer to mark}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhMhjYubah}(h]h ]h"]h$]h&]uh1j"hjYubeh}(h]h ]h"]h$]h&]uh1jhjYhMhjQYubeh}(h]h ]h"]h$]h&]uh1jhj5Yubh)}(h**Description**h]j=)}(hjYh]h Description}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjYubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj5Yubh)}(hSmark dirty metadata which needs to be journaled as part of the current transaction.h]hSmark dirty metadata which needs to be journaled as part of the current transaction.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj5Yubh)}(hThe buffer must have previously had jbd2_journal_get_write_access() called so that it has a valid journal_head attached to the buffer head.h]hThe buffer must have previously had jbd2_journal_get_write_access() called so that it has a valid journal_head attached to the buffer head.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj5Yubh)}(hfThe buffer is placed on the transaction's metadata list and is marked as belonging to the transaction.h]hhThe buffer is placed on the transaction’s metadata list and is marked as belonging to the transaction.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj5Yubh)}(h%Returns error number or 0 on success.h]h%Returns error number or 0 on success.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj5Yubh)}(hXSpecial care needs to be taken if the buffer already belongs to the current committing transaction (in which case we should have frozen data present for that commit). In that case, we don't relink the buffer: that only gets done when the old transaction finally completes its commit.h]hXSpecial care needs to be taken if the buffer already belongs to the current committing transaction (in which case we should have frozen data present for that commit). In that case, we don’t relink the buffer: that only gets done when the old transaction finally completes its commit.}(hj ZhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj5Yubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j jbd2_journal_forget (C function)c.jbd2_journal_forgethNtauh1jhjEBhhhNhNubj)}(hhh](j)}(hBint jbd2_journal_forget (handle_t *handle, struct buffer_head *bh)h]j)}(hAint jbd2_journal_forget(handle_t *handle, struct buffer_head *bh)h](j3)}(hinth]hint}(hjOZhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjKZhhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMubj)}(h h]h }(hj^ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKZhhhj]ZhMubj)}(hjbd2_journal_forgeth]j)}(hjbd2_journal_forgeth]hjbd2_journal_forget}(hjpZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlZubah}(h]h ](jjeh"]h$]h&]jjuh1jhjKZhhhj]ZhMubjk)}(h*(handle_t *handle, struct buffer_head *bh)h](jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjZmodnameN classnameNjj)}j]j)}jjrZsbc.jbd2_journal_forgetasbuh1hhjZubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hjh]h*}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hhandleh]hhandle}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjZubjq)}(hstruct buffer_head *bhh](j)}(hjVh]hstruct}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(h h]h }(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubh)}(hhh]j)}(h buffer_headh]h buffer_head}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj[modnameN classnameNjj)}j]jZc.jbd2_journal_forgetasbuh1hhjZubj)}(h h]h }(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hjh]h*}(hj-[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubj)}(hbhh]hbh}(hj:[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjZubeh}(h]h ]h"]h$]h&]jjuh1jjhjKZhhhj]ZhMubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjGZhhhj]ZhMubah}(h]jBZah ](j j eh"]h$]h&]jj)jhuh1jhj]ZhMhjDZhhubj)}(hhh]h)}(h,bforget() for potentially-journaled buffers.h]h,bforget() for potentially-journaled buffers.}(hjd[hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhja[hhubah}(h]h ]h"]h$]h&]uh1jhjDZhhhj]ZhMubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j|[j4j|[j5j6j7uh1jhhhjEBhNhNubj)}(hX**Parameters** ``handle_t *handle`` transaction handle ``struct buffer_head *bh`` bh to 'forget' **Description** We can only do the bforget if there are no commits pending against the buffer. If the buffer is dirty in the current running transaction we can safely unlink it. bh may not be a journalled buffer at all - it may be a non-JBD buffer which came off the hashtable. Check for this. Decrements bh->b_count by one. Allow this call even if the handle has aborted --- it may be part of the caller's cleanup after an abort.h](h)}(h**Parameters**h]j=)}(hj[h]h Parameters}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj[ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj[ubj)}(hhh](j)}(h(``handle_t *handle`` transaction handle h](j )}(h``handle_t *handle``h]j)}(hj[h]hhandle_t *handle}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj[ubj#)}(hhh]h)}(htransaction handleh]htransaction handle}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMhj[ubah}(h]h ]h"]h$]h&]uh1j"hj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMhj[ubj)}(h*``struct buffer_head *bh`` bh to 'forget' h](j )}(h``struct buffer_head *bh``h]j)}(hj[h]hstruct buffer_head *bh}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj[ubj#)}(hhh]h)}(hbh to 'forget'h]hbh to ‘forget’}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMhj[ubah}(h]h ]h"]h$]h&]uh1j"hj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMhj[ubeh}(h]h ]h"]h$]h&]uh1jhj[ubh)}(h**Description**h]j=)}(hj\h]h Description}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj\ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj[ubh)}(hWe can only do the bforget if there are no commits pending against the buffer. If the buffer is dirty in the current running transaction we can safely unlink it.h]hWe can only do the bforget if there are no commits pending against the buffer. If the buffer is dirty in the current running transaction we can safely unlink it.}(hj/\hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj[ubh)}(htbh may not be a journalled buffer at all - it may be a non-JBD buffer which came off the hashtable. Check for this.h]htbh may not be a journalled buffer at all - it may be a non-JBD buffer which came off the hashtable. Check for this.}(hj>\hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj[ubh)}(hDecrements bh->b_count by one.h]hDecrements bh->b_count by one.}(hjM\hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj[ubh)}(hiAllow this call even if the handle has aborted --- it may be part of the caller's cleanup after an abort.h]hkAllow this call even if the handle has aborted --- it may be part of the caller’s cleanup after an abort.}(hj\\hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj[ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jjbd2_journal_stop (C function)c.jbd2_journal_stophNtauh1jhjEBhhhNhNubj)}(hhh](j)}(h(int jbd2_journal_stop (handle_t *handle)h]j)}(h'int jbd2_journal_stop(handle_t *handle)h](j3)}(hinth]hint}(hj\hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj\hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMQubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\hhhj\hMQubj)}(hjbd2_journal_stoph]j)}(hjbd2_journal_stoph]hjbd2_journal_stop}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj\hhhj\hMQubjk)}(h(handle_t *handle)h]jq)}(hhandle_t *handleh](h)}(hhh]j)}(hhandle_th]hhandle_t}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj\modnameN classnameNjj)}j]j)}jj\sbc.jbd2_journal_stopasbuh1hhj\ubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(hjh]h*}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubj)}(hhandleh]hhandle}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj\ubah}(h]h ]h"]h$]h&]jjuh1jjhj\hhhj\hMQubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj\hhhj\hMQubah}(h]j~\ah ](j j eh"]h$]h&]jj)jhuh1jhj\hMQhj\hhubj)}(hhh]h)}(hcomplete a transactionh]hcomplete a transaction}(hj0]hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMQhj-]hhubah}(h]h ]h"]h$]h&]uh1jhj\hhhj\hMQubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3jH]j4jH]j5j6j7uh1jhhhjEBhNhNubj)}(hX?**Parameters** ``handle_t *handle`` transaction to complete. **Description** All done for a particular handle. There is not much action needed here. We just return any remaining buffer credits to the transaction and remove the handle. The only complication is that we need to start a commit operation if the filesystem is marked for synchronous update. jbd2_journal_stop itself will not usually return an error, but it may do so in unusual circumstances. In particular, expect it to return -EIO if a jbd2_journal_abort has been executed since the transaction began.h](h)}(h**Parameters**h]j=)}(hjR]h]h Parameters}(hjT]hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjP]ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMUhjL]ubj)}(hhh]j)}(h.``handle_t *handle`` transaction to complete. h](j )}(h``handle_t *handle``h]j)}(hjq]h]hhandle_t *handle}(hjs]hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjo]ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMRhjk]ubj#)}(hhh]h)}(htransaction to complete.h]htransaction to complete.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hMRhj]ubah}(h]h ]h"]h$]h&]uh1j"hjk]ubeh}(h]h ]h"]h$]h&]uh1jhj]hMRhjh]ubah}(h]h ]h"]h$]h&]uh1jhjL]ubh)}(h**Description**h]j=)}(hj]h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj]ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMThjL]ubh)}(h!All done for a particular handle.h]h!All done for a particular handle.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMShjL]ubh)}(hThere is not much action needed here. We just return any remaining buffer credits to the transaction and remove the handle. The only complication is that we need to start a commit operation if the filesystem is marked for synchronous update.h]hThere is not much action needed here. We just return any remaining buffer credits to the transaction and remove the handle. The only complication is that we need to start a commit operation if the filesystem is marked for synchronous update.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMUhjL]ubh)}(hjbd2_journal_stop itself will not usually return an error, but it may do so in unusual circumstances. In particular, expect it to return -EIO if a jbd2_journal_abort has been executed since the transaction began.h]hjbd2_journal_stop itself will not usually return an error, but it may do so in unusual circumstances. In particular, expect it to return -EIO if a jbd2_journal_abort has been executed since the transaction began.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMZhjL]ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j-jbd2_journal_try_to_free_buffers (C function)"c.jbd2_journal_try_to_free_buffershNtauh1jhjEBhhhNhNubj)}(hhh](j)}(hObool jbd2_journal_try_to_free_buffers (journal_t *journal, struct folio *folio)h]j)}(hNbool jbd2_journal_try_to_free_buffers(journal_t *journal, struct folio *folio)h](j3)}(hboolh]hbool}(hj^hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj ^hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMcubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ^hhhj^hMcubj)}(h jbd2_journal_try_to_free_buffersh]j)}(h jbd2_journal_try_to_free_buffersh]h jbd2_journal_try_to_free_buffers}(hj0^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,^ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj ^hhhj^hMcubjk)}(h)(journal_t *journal, struct folio *folio)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hjO^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjL^ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjQ^modnameN classnameNjj)}j]j)}jj2^sb"c.jbd2_journal_try_to_free_buffersasbuh1hhjH^ubj)}(h h]h }(hjo^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH^ubj)}(hjh]h*}(hj}^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH^ubj)}(hjournalh]hjournal}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjH^ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjD^ubjq)}(hstruct folio *folioh](j)}(hjVh]hstruct}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubh)}(hhh]j)}(hfolioh]hfolio}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj^modnameN classnameNjj)}j]jk^"c.jbd2_journal_try_to_free_buffersasbuh1hhj^ubj)}(h h]h }(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubj)}(hfolioh]hfolio}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphjD^ubeh}(h]h ]h"]h$]h&]jjuh1jjhj ^hhhj^hMcubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj^hhhj^hMcubah}(h]j^ah ](j j eh"]h$]h&]jj)jhuh1jhj^hMchj^hhubj)}(hhh]h)}(htry to free page buffers.h]htry to free page buffers.}(hj$_hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMchj!_hhubah}(h]h ]h"]h$]h&]uh1jhj^hhhj^hMcubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j<_j4j<_j5j6j7uh1jhhhjEBhNhNubj)}(hX**Parameters** ``journal_t *journal`` journal for operation ``struct folio *folio`` Folio to detach data from. **Description** For all the buffers on this page, if they are fully written out ordered data, move them onto BUF_CLEAN so try_to_free_buffers() can reap them. This function returns non-zero if we wish try_to_free_buffers() to be called. We do this if the page is releasable by try_to_free_buffers(). We also do it if the page has locked or dirty buffers and the caller wants us to perform sync or async writeout. This complicates JBD locking somewhat. We aren't protected by the BKL here. We wish to remove the buffer from its committing or running transaction's ->t_datalist via __jbd2_journal_unfile_buffer. This may *change* the value of transaction_t->t_datalist, so anyone who looks at t_datalist needs to lock against this function. Even worse, someone may be doing a jbd2_journal_dirty_data on this buffer. So we need to lock against that. jbd2_journal_dirty_data() will come out of the lock with the buffer dirty, which makes it ineligible for release here. Who else is affected by this? hmm... Really the only contender is do_get_write_access() - it could be looking at the buffer while journal_try_to_free_buffer() is changing its state. But that cannot happen because we never reallocate freed data as metadata while the data is part of a transaction. Yes? Return false on failure, true on successh](h)}(h**Parameters**h]j=)}(hjF_h]h Parameters}(hjH_hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjD_ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMghj@_ubj)}(hhh](j)}(h-``journal_t *journal`` journal for operation h](j )}(h``journal_t *journal``h]j)}(hje_h]hjournal_t *journal}(hjg_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjc_ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMdhj__ubj#)}(hhh]h)}(hjournal for operationh]hjournal for operation}(hj~_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjz_hMdhj{_ubah}(h]h ]h"]h$]h&]uh1j"hj__ubeh}(h]h ]h"]h$]h&]uh1jhjz_hMdhj\_ubj)}(h3``struct folio *folio`` Folio to detach data from. h](j )}(h``struct folio *folio``h]j)}(hj_h]hstruct folio *folio}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMehj_ubj#)}(hhh]h)}(hFolio to detach data from.h]hFolio to detach data from.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMehj_ubah}(h]h ]h"]h$]h&]uh1j"hj_ubeh}(h]h ]h"]h$]h&]uh1jhj_hMehj\_ubeh}(h]h ]h"]h$]h&]uh1jhj@_ubh)}(h**Description**h]j=)}(hj_h]h Description}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hj_ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMghj@_ubh)}(hFor all the buffers on this page, if they are fully written out ordered data, move them onto BUF_CLEAN so try_to_free_buffers() can reap them.h]hFor all the buffers on this page, if they are fully written out ordered data, move them onto BUF_CLEAN so try_to_free_buffers() can reap them.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMfhj@_ubh)}(hThis function returns non-zero if we wish try_to_free_buffers() to be called. We do this if the page is releasable by try_to_free_buffers(). We also do it if the page has locked or dirty buffers and the caller wants us to perform sync or async writeout.h]hThis function returns non-zero if we wish try_to_free_buffers() to be called. We do this if the page is releasable by try_to_free_buffers(). We also do it if the page has locked or dirty buffers and the caller wants us to perform sync or async writeout.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMjhj@_ubh)}(hThis complicates JBD locking somewhat. We aren't protected by the BKL here. We wish to remove the buffer from its committing or running transaction's ->t_datalist via __jbd2_journal_unfile_buffer.h]hThis complicates JBD locking somewhat. We aren’t protected by the BKL here. We wish to remove the buffer from its committing or running transaction’s ->t_datalist via __jbd2_journal_unfile_buffer.}(hj `hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMohj@_ubh)}(hThis may *change* the value of transaction_t->t_datalist, so anyone who looks at t_datalist needs to lock against this function.h](h This may }(hj`hhhNhNubhemphasis)}(h*change*h]hchange}(hj&`hhhNhNubah}(h]h ]h"]h$]h&]uh1j$`hj`ubho the value of transaction_t->t_datalist, so anyone who looks at t_datalist needs to lock against this function.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMshj@_ubh)}(hEven worse, someone may be doing a jbd2_journal_dirty_data on this buffer. So we need to lock against that. jbd2_journal_dirty_data() will come out of the lock with the buffer dirty, which makes it ineligible for release here.h]hEven worse, someone may be doing a jbd2_journal_dirty_data on this buffer. So we need to lock against that. jbd2_journal_dirty_data() will come out of the lock with the buffer dirty, which makes it ineligible for release here.}(hj?`hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMvhj@_ubh)}(hX1Who else is affected by this? hmm... Really the only contender is do_get_write_access() - it could be looking at the buffer while journal_try_to_free_buffer() is changing its state. But that cannot happen because we never reallocate freed data as metadata while the data is part of a transaction. Yes?h]hX1Who else is affected by this? hmm... Really the only contender is do_get_write_access() - it could be looking at the buffer while journal_try_to_free_buffer() is changing its state. But that cannot happen because we never reallocate freed data as metadata while the data is part of a transaction. Yes?}(hjN`hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM{hj@_ubh)}(h(Return false on failure, true on successh]h(Return false on failure, true on success}(hj]`hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chMhj@_ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j*jbd2_journal_invalidate_folio (C function)c.jbd2_journal_invalidate_foliohNtauh1jhjEBhhhNhNubj)}(hhh](j)}(hiint jbd2_journal_invalidate_folio (journal_t *journal, struct folio *folio, size_t offset, size_t length)h]j)}(hhint jbd2_journal_invalidate_folio(journal_t *journal, struct folio *folio, size_t offset, size_t length)h](j3)}(hinth]hint}(hj`hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj`hhh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM ubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhhj`hM ubj)}(hjbd2_journal_invalidate_folioh]j)}(hjbd2_journal_invalidate_folioh]hjbd2_journal_invalidate_folio}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj`hhhj`hM ubjk)}(hG(journal_t *journal, struct folio *folio, size_t offset, size_t length)h](jq)}(hjournal_t *journalh](h)}(hhh]j)}(h journal_th]h journal_t}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj`modnameN classnameNjj)}j]j)}jj`sbc.jbd2_journal_invalidate_folioasbuh1hhj`ubj)}(h h]h }(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(hjh]h*}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubj)}(hjournalh]hjournal}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj`ubjq)}(hstruct folio *folioh](j)}(hjVh]hstruct}(hj ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(h h]h }(hj-ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubh)}(hhh]j)}(hfolioh]hfolio}(hj>ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;aubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetj@amodnameN classnameNjj)}j]j`c.jbd2_journal_invalidate_folioasbuh1hhjaubj)}(h h]h }(hj\ahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hjh]h*}(hjjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hfolioh]hfolio}(hjwahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj`ubjq)}(h size_t offseth](h)}(hhh]j)}(hsize_th]hsize_t}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjamodnameN classnameNjj)}j]j`c.jbd2_journal_invalidate_folioasbuh1hhjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hoffseth]hoffset}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj`ubjq)}(h size_t lengthh](h)}(hhh]j)}(hsize_th]hsize_t}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&] refdomainjmreftypej reftargetjamodnameN classnameNjj)}j]j`c.jbd2_journal_invalidate_folioasbuh1hhjaubj)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubj)}(hlengthh]hlength}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]noemphjjuh1jphj`ubeh}(h]h ]h"]h$]h&]jjuh1jjhj`hhhj`hM ubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj`hhhj`hM ubah}(h]j`ah ](j j eh"]h$]h&]jj)jhuh1jhj`hM hj`hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj`hhhj`hM ubeh}(h]h ](jmfunctioneh"]h$]h&]j2jmj3j:bj4j:bj5j6j7uh1jhhhjEBhNhNubj)}(hX**Parameters** ``journal_t *journal`` journal to use for flush... ``struct folio *folio`` folio to flush ``size_t offset`` start of the range to invalidate ``size_t length`` length of the range to invalidate **Description** Reap page buffers containing data after in the specified range in page. Can return -EBUSY if buffers are part of the committing transaction and the page is straddling i_size. Caller then has to wait for current commit and try again.h](h)}(h**Parameters**h]j=)}(hjDbh]h Parameters}(hjFbhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjBbubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hj>bubj)}(hhh](j)}(h3``journal_t *journal`` journal to use for flush... h](j )}(h``journal_t *journal``h]j)}(hjcbh]hjournal_t *journal}(hjebhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjabubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hj]bubj#)}(hhh]h)}(hjournal to use for flush...h]hjournal to use for flush...}(hj|bhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjxbhM hjybubah}(h]h ]h"]h$]h&]uh1j"hj]bubeh}(h]h ]h"]h$]h&]uh1jhjxbhM hjZbubj)}(h'``struct folio *folio`` folio to flush h](j )}(h``struct folio *folio``h]j)}(hjbh]hstruct folio *folio}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjbubj#)}(hhh]h)}(hfolio to flushh]hfolio to flush}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhM hjbubah}(h]h ]h"]h$]h&]uh1j"hjbubeh}(h]h ]h"]h$]h&]uh1jhjbhM hjZbubj)}(h3``size_t offset`` start of the range to invalidate h](j )}(h``size_t offset``h]j)}(hjbh]h size_t offset}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjbubj#)}(hhh]h)}(h start of the range to invalidateh]h start of the range to invalidate}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhM hjbubah}(h]h ]h"]h$]h&]uh1j"hjbubeh}(h]h ]h"]h$]h&]uh1jhjbhM hjZbubj)}(h4``size_t length`` length of the range to invalidate h](j )}(h``size_t length``h]j)}(hjch]h size_t length}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj cubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hjcubj#)}(hhh]h)}(h!length of the range to invalidateh]h!length of the range to invalidate}(hj'chhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#chM hj$cubah}(h]h ]h"]h$]h&]uh1j"hjcubeh}(h]h ]h"]h$]h&]uh1jhj#chM hjZbubeh}(h]h ]h"]h$]h&]uh1jhj>bubh)}(h**Description**h]j=)}(hjIch]h Description}(hjKchhhNhNubah}(h]h ]h"]h$]h&]uh1j<hjGcubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hj>bubh)}(hReap page buffers containing data after in the specified range in page. Can return -EBUSY if buffers are part of the committing transaction and the page is straddling i_size. Caller then has to wait for current commit and try again.h]hReap page buffers containing data after in the specified range in page. Can return -EBUSY if buffers are part of the committing transaction and the page is straddling i_size. Caller then has to wait for current commit and try again.}(hj_chhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/filesystems/journalling:203: ./fs/jbd2/transaction.chM hj>bubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjEBhhhNhNubeh}(h]transaction-levelah ]h"]transaction levelah$]h&]uh1hhjhhhhhKubeh}(h] functionsah ]h"] functionsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hSee alsoh]hSee also}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchhhhhKubh)}(h`Journaling the Linux ext2fs Filesystem, LinuxExpo 98, Stephen Tweedie `__h]h reference)}(hjch]hEJournaling the Linux ext2fs Filesystem, LinuxExpo 98, Stephen Tweedie}(hjchhhNhNubah}(h]h ]h"]h$]h&]nameEJournaling the Linux ext2fs Filesystem, LinuxExpo 98, Stephen TweedierefuriGhttp://kernel.org/pub/linux/kernel/people/sct/ext3/journal-design.ps.gzuh1jchjcubah}(h]h ]h"]h$]h&]uh1hhhhKhjchhubh)}(h`Ext3 Journalling FileSystem, OLS 2000, Dr. Stephen Tweedie `__h]jc)}(hjch]h:Ext3 Journalling FileSystem, OLS 2000, Dr. Stephen Tweedie}(hjchhhNhNubah}(h]h ]h"]h$]h&]name:Ext3 Journalling FileSystem, OLS 2000, Dr. Stephen TweediejcFhttp://olstrans.sourceforge.net/release/OLS2000-ext3/OLS2000-ext3.htmluh1jchjcubah}(h]h ]h"]h$]h&]uh1hhhhKhjchhubeh}(h]see-alsoah ]h"]see alsoah$]h&]uh1hhhhhhhhKubeh}(h]the-linux-journalling-apiah ]h"]the linux journalling apiah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_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_handlerjderror_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}(jcjcjgjdjjj8j5j_j\jjjjjcjcjBBj?Bjzcjwcjcjcu nametypes}(jcjgjj8j_jjjcjBBjzcjcuh}(jchjdhjhj5jj\j;jjjjjjjjjjGjLjj j j jcjj?Bjj%j*j j j"j "j&j &j'j'j )j)jq*jv*j+j+j.j.j1j1j4j4j 7j7j8j8j;j#;j<j<j=j=j_?jd?j@j@jwcjEBjbBjgBjeDjjDjGjGjoIjtIjALjFLjMjMj+Oj0OjsQjxQjSjSjUjUjWjWjBZjGZj~\j\j^j^j`j`jcjcu 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.