sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget*/translations/zh_CN/admin-guide/pstore-blkmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/zh_TW/admin-guide/pstore-blkmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/it_IT/admin-guide/pstore-blkmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/ja_JP/admin-guide/pstore-blkmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/ko_KR/admin-guide/pstore-blkmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/sp_SP/admin-guide/pstore-blkmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhD/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk.rsthKubhsection)}(hhh](htitle)}(hpstore block oops/panic loggerh]hpstore block oops/panic logger}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Introductionh]h Introduction}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hpstore block (pstore/blk) is an oops/panic logger that writes its logs to a block device and non-block device before the system crashes. You can get these log files by mounting pstore filesystem like::h]hpstore block (pstore/blk) is an oops/panic logger that writes its logs to a block device and non-block device before the system crashes. You can get these log files by mounting pstore filesystem like:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh literal_block)}(h%mount -t pstore pstore /sys/fs/pstoreh]h%mount -t pstore pstore /sys/fs/pstore}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhK hhhhubeh}(h] introductionah ]h"] introductionah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hpstore block conceptsh]hpstore block concepts}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hpstore/blk provides efficient configuration method for pstore/blk, which divides all configurations into two parts, configurations for user and configurations for driver.h]hpstore/blk provides efficient configuration method for pstore/blk, which divides all configurations into two parts, configurations for user and configurations for driver.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hConfigurations for user determine how pstore/blk works, such as pmsg_size, kmsg_size and so on. All of them support both Kconfig and module parameters, but module parameters have priority over Kconfig.h]hConfigurations for user determine how pstore/blk works, such as pmsg_size, kmsg_size and so on. All of them support both Kconfig and module parameters, but module parameters have priority over Kconfig.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hConfigurations for driver are all about block device and non-block device, such as total_size of block device and read/write operations.h]hConfigurations for driver are all about block device and non-block device, such as total_size of block device and read/write operations.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]pstore-block-conceptsah ]h"]pstore block conceptsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hConfigurations for userh]hConfigurations for user}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEhhhhhKubh)}(hyAll of these configurations support both Kconfig and module parameters, but module parameters have priority over Kconfig.h]hyAll of these configurations support both Kconfig and module parameters, but module parameters have priority over Kconfig.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK!hjEhhubh)}(h*Here is an example for module parameters::h]h)Here is an example for module parameters:}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK$hjEhhubh)}(hFpstore_blk.blkdev=/dev/mmcblk0p7 pstore_blk.kmsg_size=64 best_effort=yh]hFpstore_blk.blkdev=/dev/mmcblk0p7 pstore_blk.kmsg_size=64 best_effort=y}hjrsbah}(h]h ]h"]h$]h&]hhuh1hhhhK&hjEhhubh)}(h represents the device number of diskh]h)}(hjh]h5/dev/ represents the device number of disk}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK2hjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hu/dev/ represents the device number of partition - device number of disk plus the partition numberh]h)}(hu/dev/ represents the device number of partition - device number of disk plus the partition numberh]hu/dev/ represents the device number of partition - device number of disk plus the partition number}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hx/dev/p - same as the above; this form is used when disk name of partitioned disk ends with a digit. h]h)}(hw/dev/p - same as the above; this form is used when disk name of partitioned disk ends with a digit.h]hw/dev/p - same as the above; this form is used when disk name of partitioned disk ends with a digit.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1jhjhhhhhK2ubh)}(hRWhen pstore/blk is built into the kernel, "blkdev" accepts the following variants:h]hVWhen pstore/blk is built into the kernel, “blkdev” accepts the following variants:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjhhubj)}(hhh](j)}(hi device number in hexadecimal representation, with no leading 0x, for example b302.h]h)}(hi device number in hexadecimal representation, with no leading 0x, for example b302.h]hi device number in hexadecimal representation, with no leading 0x, for example b302.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hj%ubah}(h]h ]h"]h$]h&]uh1jhj"hhhhhNubj)}(hXPARTUUID=00112233-4455-6677-8899-AABBCCDDEEFF represents the unique id of a partition if the partition table provides it. The UUID may be either an EFI/GPT UUID, or refer to an MSDOS partition using the format SSSSSSSS-PP, where SSSSSSSS is a zero-filled hex representation of the 32-bit "NT disk signature", and PP is a zero-filled hex representation of the 1-based partition number.h]h)}(hXPARTUUID=00112233-4455-6677-8899-AABBCCDDEEFF represents the unique id of a partition if the partition table provides it. The UUID may be either an EFI/GPT UUID, or refer to an MSDOS partition using the format SSSSSSSS-PP, where SSSSSSSS is a zero-filled hex representation of the 32-bit "NT disk signature", and PP is a zero-filled hex representation of the 1-based partition number.h]hXPARTUUID=00112233-4455-6677-8899-AABBCCDDEEFF represents the unique id of a partition if the partition table provides it. The UUID may be either an EFI/GPT UUID, or refer to an MSDOS partition using the format SSSSSSSS-PP, where SSSSSSSS is a zero-filled hex representation of the 32-bit “NT disk signature”, and PP is a zero-filled hex representation of the 1-based partition number.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/PARTNROFF= to select a partition in relation to a partition with a known unique id.h]h)}(hhPARTUUID=/PARTNROFF= to select a partition in relation to a partition with a known unique id.h]hhPARTUUID=/PARTNROFF= to select a partition in relation to a partition with a known unique id.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjUubah}(h]h ]h"]h$]h&]uh1jhj"hhhhhNubj)}(hK: major and minor number of the device separated by a colon. h]h)}(hJ: major and minor number of the device separated by a colon.h]hJ: major and minor number of the device separated by a colon.}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjmubah}(h]h ]h"]h$]h&]uh1jhj"hhhhhNubeh}(h]h ]h"]h$]h&]jjjhjjuh1jhjhhhhhK:ubh)}(h1It accepts the following variants for MTD device:h]h1It accepts the following variants for MTD device:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjhhubj)}(hhh](j)}(h7 MTD device name. "pstore" is recommended.h]h)}(hjh]h; MTD device name. “pstore” is recommended.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h# MTD device number. h]h)}(h" MTD device number.h]h" MTD device number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]jjjhjjuh1jhjhhhhhKHubeh}(h]blkdevah ]h"]blkdevah$]h&]uh1hhjEhhhhhK+ubh)}(hhh](h)}(h kmsg_sizeh]h kmsg_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKLubh)}(hThe chunk size in KB for oops/panic front-end. It **MUST** be a multiple of 4. It's optional if you do not care about the oops/panic log.h](h2The chunk size in KB for oops/panic front-end. It }(hjhhhNhNubhstrong)}(h**MUST**h]hMUST}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhQ be a multiple of 4. It’s optional if you do not care about the oops/panic log.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKNhjhhubh)}(hsThere are multiple chunks for oops/panic front-end depending on the remaining space except other pstore front-ends.h]hsThere are multiple chunks for oops/panic front-end depending on the remaining space except other pstore front-ends.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjhhubh)}(hzpstore/blk will log to oops/panic chunks one by one, and always overwrite the oldest chunk if there is no more free chunk.h]hzpstore/blk will log to oops/panic chunks one by one, and always overwrite the oldest chunk if there is no more free chunk.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjhhubeh}(h] kmsg-sizeah ]h"] kmsg_sizeah$]h&]uh1hhjEhhhhhKLubh)}(hhh](h)}(h pmsg_sizeh]h pmsg_size}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hhhhhKXubh)}(h}The chunk size in KB for pmsg front-end. It **MUST** be a multiple of 4. It's optional if you do not care about the pmsg log.h](h,The chunk size in KB for pmsg front-end. It }(hjAhhhNhNubj)}(h**MUST**h]hMUST}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubhK be a multiple of 4. It’s optional if you do not care about the pmsg log.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKZhj0hhubh)}(hHUnlike oops/panic front-end, there is only one chunk for pmsg front-end.h]hHUnlike oops/panic front-end, there is only one chunk for pmsg front-end.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hj0hhubh)}(hPmsg is a user space accessible pstore object. Writes to */dev/pmsg0* are appended to the chunk. On reboot the contents are available in */sys/fs/pstore/pmsg-pstore-blk-0*.h](h9Pmsg is a user space accessible pstore object. Writes to }(hjohhhNhNubhemphasis)}(h */dev/pmsg0*h]h /dev/pmsg0}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jwhjoubhD are appended to the chunk. On reboot the contents are available in }(hjohhhNhNubjx)}(h"*/sys/fs/pstore/pmsg-pstore-blk-0*h]h /sys/fs/pstore/pmsg-pstore-blk-0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jwhjoubh.}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK_hj0hhubeh}(h] pmsg-sizeah ]h"] pmsg_sizeah$]h&]uh1hhjEhhhhhKXubh)}(hhh](h)}(h console_sizeh]h console_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKdubh)}(hThe chunk size in KB for console front-end. It **MUST** be a multiple of 4. It's optional if you do not care about the console log.h](h0The chunk size in KB for console front-end. It }(hjhhhNhNubj)}(h**MUST**h]hMUST}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhN be a multiple of 4. It’s optional if you do not care about the console log.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKfhjhhubh)}(hISimilar to pmsg front-end, there is only one chunk for console front-end.h]hISimilar to pmsg front-end, there is only one chunk for console front-end.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihjhhubh)}(hAll log of console will be appended to the chunk. On reboot the contents are available in */sys/fs/pstore/console-pstore-blk-0*.h](hZAll log of console will be appended to the chunk. On reboot the contents are available in }(hjhhhNhNubjx)}(h%*/sys/fs/pstore/console-pstore-blk-0*h]h#/sys/fs/pstore/console-pstore-blk-0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jwhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKkhjhhubeh}(h] console-sizeah ]h"] console_sizeah$]h&]uh1hhjEhhhhhKdubh)}(hhh](h)}(h ftrace_sizeh]h ftrace_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKoubh)}(hThe chunk size in KB for ftrace front-end. It **MUST** be a multiple of 4. It's optional if you do not care about the ftrace log.h](h.The chunk size in KB for ftrace front-end. It }(hj#hhhNhNubj)}(h**MUST**h]hMUST}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubhM be a multiple of 4. It’s optional if you do not care about the ftrace log.}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKqhjhhubh)}(hSimilar to oops front-end, there are multiple chunks for ftrace front-end depending on the count of cpu processors. Each chunk size is equal to ftrace_size / processors_count.h]hSimilar to oops front-end, there are multiple chunks for ftrace front-end depending on the count of cpu processors. Each chunk size is equal to ftrace_size / processors_count.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthjhhubh)}(hAll log of ftrace will be appended to the chunk. On reboot the contents are combined and available in */sys/fs/pstore/ftrace-pstore-blk-0*.h](hfAll log of ftrace will be appended to the chunk. On reboot the contents are combined and available in }(hjQhhhNhNubjx)}(h$*/sys/fs/pstore/ftrace-pstore-blk-0*h]h"/sys/fs/pstore/ftrace-pstore-blk-0}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jwhjQubh.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKxhjhhubh)}(h{Persistent function tracing might be useful for debugging software or hardware related hangs. Here is an example of usage::h]hzPersistent function tracing might be useful for debugging software or hardware related hangs. Here is an example of usage:}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK{hjhhubh)}(hX# mount -t pstore pstore /sys/fs/pstore # mount -t debugfs debugfs /sys/kernel/debug/ # echo 1 > /sys/kernel/debug/pstore/record_ftrace # reboot -f [...] # mount -t pstore pstore /sys/fs/pstore # tail /sys/fs/pstore/ftrace-pstore-blk-0 CPU:0 ts:5914676 c0063828 c0063b94 call_cpuidle <- cpu_startup_entry+0x1b8/0x1e0 CPU:0 ts:5914678 c039ecdc c006385c cpuidle_enter_state <- call_cpuidle+0x44/0x48 CPU:0 ts:5914680 c039e9a0 c039ecf0 cpuidle_enter_freeze <- cpuidle_enter_state+0x304/0x314 CPU:0 ts:5914681 c0063870 c039ea30 sched_idle_set_state <- cpuidle_enter_state+0x44/0x314 CPU:1 ts:5916720 c0160f59 c015ee04 kernfs_unmap_bin_file <- __kernfs_remove+0x140/0x204 CPU:1 ts:5916721 c05ca625 c015ee0c __mutex_lock_slowpath <- __kernfs_remove+0x148/0x204 CPU:1 ts:5916723 c05c813d c05ca630 yield_to <- __mutex_lock_slowpath+0x314/0x358 CPU:1 ts:5916724 c05ca2d1 c05ca638 __ww_mutex_lock <- __mutex_lock_slowpath+0x31c/0x358h]hX# mount -t pstore pstore /sys/fs/pstore # mount -t debugfs debugfs /sys/kernel/debug/ # echo 1 > /sys/kernel/debug/pstore/record_ftrace # reboot -f [...] # mount -t pstore pstore /sys/fs/pstore # tail /sys/fs/pstore/ftrace-pstore-blk-0 CPU:0 ts:5914676 c0063828 c0063b94 call_cpuidle <- cpu_startup_entry+0x1b8/0x1e0 CPU:0 ts:5914678 c039ecdc c006385c cpuidle_enter_state <- call_cpuidle+0x44/0x48 CPU:0 ts:5914680 c039e9a0 c039ecf0 cpuidle_enter_freeze <- cpuidle_enter_state+0x304/0x314 CPU:0 ts:5914681 c0063870 c039ea30 sched_idle_set_state <- cpuidle_enter_state+0x44/0x314 CPU:1 ts:5916720 c0160f59 c015ee04 kernfs_unmap_bin_file <- __kernfs_remove+0x140/0x204 CPU:1 ts:5916721 c05ca625 c015ee0c __mutex_lock_slowpath <- __kernfs_remove+0x148/0x204 CPU:1 ts:5916723 c05c813d c05ca630 yield_to <- __mutex_lock_slowpath+0x314/0x358 CPU:1 ts:5916724 c05ca2d1 c05ca638 __ww_mutex_lock <- __mutex_lock_slowpath+0x31c/0x358}hjsbah}(h]h ]h"]h$]h&]hhuh1hhhhK~hjhhubeh}(h] ftrace-sizeah ]h"] ftrace_sizeah$]h&]uh1hhjEhhhhhKoubh)}(hhh](h)}(h max_reasonh]h max_reason}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hX Limiting which kinds of kmsg dumps are stored can be controlled via the ``max_reason`` value, as defined in include/linux/kmsg_dump.h's ``enum kmsg_dump_reason``. For example, to store both Oopses and Panics, ``max_reason`` should be set to 2 (KMSG_DUMP_OOPS), to store only Panics ``max_reason`` should be set to 1 (KMSG_DUMP_PANIC). Setting this to 0 (KMSG_DUMP_UNDEF), means the reason filtering will be controlled by the ``printk.always_kmsg_dump`` boot param: if unset, it'll be KMSG_DUMP_OOPS, otherwise KMSG_DUMP_MAX.h](hHLimiting which kinds of kmsg dumps are stored can be controlled via the }(hjhhhNhNubhliteral)}(h``max_reason``h]h max_reason}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh4 value, as defined in include/linux/kmsg_dump.h’s }(hjhhhNhNubj)}(h``enum kmsg_dump_reason``h]henum kmsg_dump_reason}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh0. For example, to store both Oopses and Panics, }(hjhhhNhNubj)}(h``max_reason``h]h max_reason}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh; should be set to 2 (KMSG_DUMP_OOPS), to store only Panics }(hjhhhNhNubj)}(h``max_reason``h]h max_reason}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh should be set to 1 (KMSG_DUMP_PANIC). Setting this to 0 (KMSG_DUMP_UNDEF), means the reason filtering will be controlled by the }(hjhhhNhNubj)}(h``printk.always_kmsg_dump``h]hprintk.always_kmsg_dump}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhJ boot param: if unset, it’ll be KMSG_DUMP_OOPS, otherwise KMSG_DUMP_MAX.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] max-reasonah ]h"] max_reasonah$]h&]uh1hhjEhhhhhKubeh}(h]configurations-for-userah ]h"]configurations for userah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hConfigurations for driverh]hConfigurations for driver}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubh)}(hmA device driver uses ``register_pstore_device`` with ``struct pstore_device_info`` to register to pstore/blk.h](hA device driver uses }(hj1hhhNhNubj)}(h``register_pstore_device``h]hregister_pstore_device}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubh with }(hj1hhhNhNubj)}(h``struct pstore_device_info``h]hstruct pstore_device_info}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubh to register to pstore/blk.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj hhubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single#register_pstore_device (C function)c.register_pstore_devicehNtauh1jchj hhhNhNubhdesc)}(hhh](hdesc_signature)}(h;int register_pstore_device (struct pstore_device_info *dev)h]hdesc_signature_line)}(h:int register_pstore_device(struct pstore_device_info *dev)h](hdesc_sig_keyword_type)}(hinth]hint}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhKubh desc_name)}(hregister_pstore_deviceh]h desc_sig_name)}(hregister_pstore_deviceh]hregister_pstore_device}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhjhhhjhKubhdesc_parameterlist)}(h (struct pstore_device_info *dev)h]hdesc_parameter)}(hstruct pstore_device_info *devh](hdesc_sig_keyword)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpstore_device_infoh]hpstore_device_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}j jsbc.register_pstore_deviceasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubhdesc_sig_punctuation)}(h*h]h*}(hj.hhhNhNubah}(h]h ]pah"]h$]h&]uh1j,hjubj)}(hdevh]hdev}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hh add_permalinkuh1jsphinx_line_type declaratorhj{hhhjhKubah}(h]jrah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jyhjhKhjvhhubh desc_content)}(hhh]h)}(h'register non-block device to pstore/blkh]h'register non-block device to pstore/blk}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhjnhhubah}(h]h ]h"]h$]h&]uh1jlhjvhhhjhKubeh}(h]h ](j functioneh"]h$]h&]domainj objtypejdesctypejnoindex noindexentrynocontentsentryuh1jthhhj hNhNubh container)}(h**Parameters** ``struct pstore_device_info *dev`` non-block device information **Return** * 0 - OK * Others - something error.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhjubhdefinition_list)}(hhh]hdefinition_list_item)}(h@``struct pstore_device_info *dev`` non-block device information h](hterm)}(h"``struct pstore_device_info *dev``h]j)}(hjh]hstruct pstore_device_info *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhjubh definition)}(hhh]h)}(hnon-block device informationh]hnon-block device information}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhjubh bullet_list)}(hhh](j)}(h0 - OKh]h)}(hjh]h0 - OK}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hOthers - something error.h]h)}(hj2h]hOthers - something error.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhj0ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]bulletj0uh1jhj)hKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubjd)}(hhh]h}(h]h ]h"]h$]h&]entries](jp%unregister_pstore_device (C function)c.unregister_pstore_devicehNtauh1jchj hhhNhNubju)}(hhh](jz)}(h>void unregister_pstore_device (struct pstore_device_info *dev)h]j)}(h=void unregister_pstore_device(struct pstore_device_info *dev)h](j)}(hvoidh]hvoid}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkhhhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKubj)}(h h]h }(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkhhhj}hKubj)}(hunregister_pstore_deviceh]j)}(hunregister_pstore_deviceh]hunregister_pstore_device}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjkhhhj}hKubj)}(h (struct pstore_device_info *dev)h]j)}(hstruct pstore_device_info *devh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hpstore_device_infoh]hpstore_device_info}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj reftypej  reftargetjmodnameN classnameNjj)}j]j)}j jsbc.unregister_pstore_deviceasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hj0h]h*}(hjhhhNhNubah}(h]h ]j9ah"]h$]h&]uh1j,hjubj)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjkhhhj}hKubeh}(h]h ]h"]h$]h&]hhj^uh1jj_j`hjghhhj}hKubah}(h]jbah ](jdjeeh"]h$]h&]jijj)jkhuh1jyhj}hKhjdhhubjm)}(hhh]h)}(h+unregister non-block device from pstore/blkh]h+unregister non-block device from pstore/blk}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhj,hhubah}(h]h ]h"]h$]h&]uh1jlhjdhhhj}hKubeh}(h]h ](j functioneh"]h$]h&]jj jjGjjGjjjuh1jthhhj hNhNubj)}(hQ**Parameters** ``struct pstore_device_info *dev`` non-block device informationh](h)}(h**Parameters**h]j)}(hjQh]h Parameters}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhjKubj)}(hhh]j)}(h?``struct pstore_device_info *dev`` non-block device informationh](j)}(h"``struct pstore_device_info *dev``h]j)}(hjph]hstruct pstore_device_info *dev}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhjjubj)}(hhh]h)}(hnon-block device informationh]hnon-block device information}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:160: ./fs/pstore/blk.chKhjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubeh}(h]configurations-for-driverah ]h"]configurations for driverah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hCompression and headerh]hCompression and header}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hBlock device is large enough for uncompressed oops data. Actually we do not recommend data compression because pstore/blk will insert some information into the first line of oops/panic data. For example::h]hBlock device is large enough for uncompressed oops data. Actually we do not recommend data compression because pstore/blk will insert some information into the first line of oops/panic data. For example:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hPanic: Total 16 timesh]hPanic: Total 16 times}hjsbah}(h]h ]h"]h$]h&]hhuh1hhhhKhjhhubh)}(hIt means that it's OOPS|Panic for the 16th time since the first booting. Sometimes the number of occurrences of oops|panic since the first booting is important to judge whether the system is stable.h]hIt means that it’s OOPS|Panic for the 16th time since the first booting. Sometimes the number of occurrences of oops|panic since the first booting is important to judge whether the system is stable.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hBThe following line is inserted by pstore filesystem. For example::h]hAThe following line is inserted by pstore filesystem. For example:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h Oops#2 Part1h]h Oops#2 Part1}hj sbah}(h]h ]h"]h$]h&]hhuh1hhhhKhjhhubh)}(h:It means that it's OOPS for the 2nd time on the last boot.h]hdata** ``should_recover`` whether this zone should recover from storage ``dirty`` whether the data in **buffer** dirtyh](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubh:}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKDhjuubh)}(hstruct pstore_zone { loff_t off; const char *name; enum pstore_type_id type; struct psz_buffer *buffer; struct psz_buffer *oldbuf; size_t buffer_size; bool should_recover; atomic_t dirty; };h]hstruct pstore_zone { loff_t off; const char *name; enum pstore_type_id type; struct psz_buffer *buffer; struct psz_buffer *oldbuf; size_t buffer_size; bool should_recover; atomic_t dirty; };}hjsbah}(h]h ]h"]h$]h&]hhuh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKFhjuubh)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKQhjuubj)}(hhh](j)}(h``off`` zone offset of storage h](j)}(h``off``h]j)}(hjh]hoff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKChjubj)}(hhh]h)}(hzone offset of storageh]hzone offset of storage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKChjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKChjubj)}(h&``name`` front-end name for this zone h](j)}(h``name``h]j)}(hjh]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKEhjubj)}(hhh]h)}(hfront-end name for this zoneh]hfront-end name for this zone}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKEhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKEhjubj)}(h&``type`` front-end type for this zone h](j)}(h``type``h]j)}(hj8h]htype}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKDhj2ubj)}(hhh]h)}(hfront-end type for this zoneh]hfront-end type for this zone}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhKDhjNubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhjMhKDhjubj)}(h7``buffer`` pointer to data buffer managed by this zone h](j)}(h ``buffer``h]j)}(hjqh]hbuffer}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKFhjkubj)}(hhh]h)}(h+pointer to data buffer managed by this zoneh]h+pointer to data buffer managed by this zone}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKFhjubah}(h]h ]h"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]uh1jhjhKFhjubj)}(h&``oldbuf`` pointer to old data buffer h](j)}(h ``oldbuf``h]j)}(hjh]holdbuf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKGhjubj)}(hhh]h)}(hpointer to old data bufferh]hpointer to old data buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKGhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKGhjubj)}(h*``buffer_size`` bytes in **buffer->data** h](j)}(h``buffer_size``h]j)}(hjh]h buffer_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKHhjubj)}(hhh]h)}(hbytes in **buffer->data**h](h bytes in }(hjhhhNhNubj)}(h**buffer->data**h]h buffer->data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhKHhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKHhjubj)}(hA``should_recover`` whether this zone should recover from storage h](j)}(h``should_recover``h]j)}(hj*h]hshould_recover}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKIhj$ubj)}(hhh]h)}(h-whether this zone should recover from storageh]h-whether this zone should recover from storage}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hKIhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hKIhjubj)}(h.``dirty`` whether the data in **buffer** dirtyh](j)}(h ``dirty``h]j)}(hjch]hdirty}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjaubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKIhj]ubj)}(hhh]h)}(h$whether the data in **buffer** dirtyh](hwhether the data in }(hj|hhhNhNubj)}(h **buffer**h]hbuffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubh dirty}(hj|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKJhjyubah}(h]h ]h"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]uh1jhjxhKIhjubeh}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKMhj hhubh)}(hzone structure in memory.h]hzone structure in memory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKKhj hhubjd)}(hhh]h}(h]h ]h"]h$]h&]entries](jppsz_context (C struct) c.psz_contexthNtauh1jchj hhhNhNubju)}(hhh](jz)}(h psz_contexth]j)}(hstruct psz_contexth](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKPubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKPubj)}(h psz_contexth]j)}(hjh]h psz_context}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKPubeh}(h]h ]h"]h$]h&]hhj^uh1jj_j`hjhhhjhKPubah}(h]jah ](jdjeeh"]h$]h&]jijj)jkhuh1jyhjhKPhjhhubjm)}(hhh]h)}(h&all about running state of pstore/zoneh]h&all about running state of pstore/zone}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKZhj5hhubah}(h]h ]h"]h$]h&]uh1jlhjhhhjhKPubeh}(h]h ](j structeh"]h$]h&]jj jjPjjPjjjuh1jthhhj hNhNubj)}(hX**Definition**:: struct psz_context { struct pstore_zone **kpszs; struct pstore_zone *ppsz; struct pstore_zone *cpsz; struct pstore_zone **fpszs; unsigned int kmsg_max_cnt; unsigned int kmsg_read_cnt; unsigned int kmsg_write_cnt; unsigned int pmsg_read_cnt; unsigned int console_read_cnt; unsigned int ftrace_max_cnt; unsigned int ftrace_read_cnt; unsigned int oops_counter; unsigned int panic_counter; atomic_t recovered; atomic_t on_panic; struct mutex pstore_zone_info_lock; struct pstore_zone_info *pstore_zone_info; struct pstore_info pstore; }; **Members** ``kpszs`` kmsg dump storage zones ``ppsz`` pmsg storage zone ``cpsz`` console storage zone ``fpszs`` ftrace storage zones ``kmsg_max_cnt`` max count of **kpszs** ``kmsg_read_cnt`` counter of total read kmsg dumps ``kmsg_write_cnt`` counter of total kmsg dump writes ``pmsg_read_cnt`` counter of total read pmsg zone ``console_read_cnt`` counter of total read console zone ``ftrace_max_cnt`` max count of **fpszs** ``ftrace_read_cnt`` counter of max read ftrace zone ``oops_counter`` counter of oops dumps ``panic_counter`` counter of panic dumps ``recovered`` whether finished recovering data from storage ``on_panic`` whether panic is happening ``pstore_zone_info_lock`` lock to **pstore_zone_info** ``pstore_zone_info`` information from backend ``pstore`` structure for pstoreh](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjXubh:}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chK^hjTubh)}(hX]struct psz_context { struct pstore_zone **kpszs; struct pstore_zone *ppsz; struct pstore_zone *cpsz; struct pstore_zone **fpszs; unsigned int kmsg_max_cnt; unsigned int kmsg_read_cnt; unsigned int kmsg_write_cnt; unsigned int pmsg_read_cnt; unsigned int console_read_cnt; unsigned int ftrace_max_cnt; unsigned int ftrace_read_cnt; unsigned int oops_counter; unsigned int panic_counter; atomic_t recovered; atomic_t on_panic; struct mutex pstore_zone_info_lock; struct pstore_zone_info *pstore_zone_info; struct pstore_info pstore; };h]hX]struct psz_context { struct pstore_zone **kpszs; struct pstore_zone *ppsz; struct pstore_zone *cpsz; struct pstore_zone **fpszs; unsigned int kmsg_max_cnt; unsigned int kmsg_read_cnt; unsigned int kmsg_write_cnt; unsigned int pmsg_read_cnt; unsigned int console_read_cnt; unsigned int ftrace_max_cnt; unsigned int ftrace_read_cnt; unsigned int oops_counter; unsigned int panic_counter; atomic_t recovered; atomic_t on_panic; struct mutex pstore_zone_info_lock; struct pstore_zone_info *pstore_zone_info; struct pstore_info pstore; };}hjusbah}(h]h ]h"]h$]h&]hhuh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chK`hjTubh)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKuhjTubj)}(hhh](j)}(h"``kpszs`` kmsg dump storage zones h](j)}(h ``kpszs``h]j)}(hjh]hkpszs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chK]hjubj)}(hhh]h)}(hkmsg dump storage zonesh]hkmsg dump storage zones}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK]hjubj)}(h``ppsz`` pmsg storage zone h](j)}(h``ppsz``h]j)}(hjh]hppsz}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chK^hjubj)}(hhh]h)}(hpmsg storage zoneh]hpmsg storage zone}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK^hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK^hjubj)}(h``cpsz`` console storage zone h](j)}(h``cpsz``h]j)}(hjh]hcpsz}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chK_hjubj)}(hhh]h)}(hconsole storage zoneh]hconsole storage zone}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hK_hj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hK_hjubj)}(h``fpszs`` ftrace storage zones h](j)}(h ``fpszs``h]j)}(hjPh]hfpszs}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chK`hjJubj)}(hhh]h)}(hftrace storage zonesh]hftrace storage zones}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehK`hjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehK`hjubj)}(h(``kmsg_max_cnt`` max count of **kpszs** h](j)}(h``kmsg_max_cnt``h]j)}(hjh]h kmsg_max_cnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKahjubj)}(hhh]h)}(hmax count of **kpszs**h](h max count of }(hjhhhNhNubj)}(h **kpszs**h]hkpszs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhKahjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKahjubj)}(h3``kmsg_read_cnt`` counter of total read kmsg dumps h](j)}(h``kmsg_read_cnt``h]j)}(hjh]h kmsg_read_cnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKbhjubj)}(hhh]h)}(h counter of total read kmsg dumpsh]h counter of total read kmsg dumps}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKbhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKbhjubj)}(h5``kmsg_write_cnt`` counter of total kmsg dump writes h](j)}(h``kmsg_write_cnt``h]j)}(hj h]hkmsg_write_cnt}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKchjubj)}(hhh]h)}(h!counter of total kmsg dump writesh]h!counter of total kmsg dump writes}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKchjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKchjubj)}(h2``pmsg_read_cnt`` counter of total read pmsg zone h](j)}(h``pmsg_read_cnt``h]j)}(hjBh]h pmsg_read_cnt}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKdhj<ubj)}(hhh]h)}(hcounter of total read pmsg zoneh]hcounter of total read pmsg zone}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhKdhjXubah}(h]h ]h"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]uh1jhjWhKdhjubj)}(h8``console_read_cnt`` counter of total read console zone h](j)}(h``console_read_cnt``h]j)}(hj{h]hconsole_read_cnt}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKehjuubj)}(hhh]h)}(h"counter of total read console zoneh]h"counter of total read console zone}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKehjubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjhKehjubj)}(h*``ftrace_max_cnt`` max count of **fpszs** h](j)}(h``ftrace_max_cnt``h]j)}(hjh]hftrace_max_cnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKfhjubj)}(hhh]h)}(hmax count of **fpszs**h](h max count of }(hjhhhNhNubj)}(h **fpszs**h]hfpszs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhKfhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKfhjubj)}(h4``ftrace_read_cnt`` counter of max read ftrace zone h](j)}(h``ftrace_read_cnt``h]j)}(hjh]hftrace_read_cnt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKghjubj)}(hhh]h)}(hcounter of max read ftrace zoneh]hcounter of max read ftrace zone}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKghjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKghjubj)}(h'``oops_counter`` counter of oops dumps h](j)}(h``oops_counter``h]j)}(hj4h]h oops_counter}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKhhj.ubj)}(hhh]h)}(hcounter of oops dumpsh]hcounter of oops dumps}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhKhhjJubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhKhhjubj)}(h)``panic_counter`` counter of panic dumps h](j)}(h``panic_counter``h]j)}(hjmh]h panic_counter}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKihjgubj)}(hhh]h)}(hcounter of panic dumpsh]hcounter of panic dumps}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKihjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhKihjubj)}(h<``recovered`` whether finished recovering data from storage h](j)}(h ``recovered``h]j)}(hjh]h recovered}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKjhjubj)}(hhh]h)}(h-whether finished recovering data from storageh]h-whether finished recovering data from storage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKjhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKjhjubj)}(h(``on_panic`` whether panic is happening h](j)}(h ``on_panic``h]j)}(hjh]hon_panic}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKkhjubj)}(hhh]h)}(hwhether panic is happeningh]hwhether panic is happening}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKkhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKkhjubj)}(h7``pstore_zone_info_lock`` lock to **pstore_zone_info** h](j)}(h``pstore_zone_info_lock``h]j)}(hjh]hpstore_zone_info_lock}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKlhjubj)}(hhh]h)}(hlock to **pstore_zone_info**h](hlock to }(hj1hhhNhNubj)}(h**pstore_zone_info**h]hpstore_zone_info}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1hhj-hKlhj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hKlhjubj)}(h.``pstore_zone_info`` information from backend h](j)}(h``pstore_zone_info``h]j)}(hj_h]hpstore_zone_info}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKmhjYubj)}(hhh]h)}(hinformation from backendh]hinformation from backend}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthKmhjuubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjthKmhjubj)}(h``pstore`` structure for pstoreh](j)}(h ``pstore``h]j)}(hjh]hpstore}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKmhjubj)}(hhh]h)}(hstructure for pstoreh]hstructure for pstore}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKnhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKmhjubeh}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubjd)}(hhh]h}(h]h ]h"]h$]h&]entries](jppsz_flush_mode (C enum)c.psz_flush_modehNtauh1jchj hhhNhNubju)}(hhh](jz)}(hpsz_flush_modeh]j)}(henum psz_flush_modeh](j)}(henumh]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKtubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKtubj)}(hpsz_flush_modeh]j)}(hjh]hpsz_flush_mode}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKtubeh}(h]h ]h"]h$]h&]hhj^uh1jj_j`hjhhhjhKtubah}(h]jah ](jdjeeh"]h$]h&]jijj)jkhuh1jyhjhKthjhhubjm)}(hhh]h)}(hflush mode for psz_zone_write()h]hflush mode for psz_zone_write()}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKhj2hhubah}(h]h ]h"]h$]h&]uh1jlhjhhhjhKtubeh}(h]h ](j enumeh"]h$]h&]jj jjMjjMjjjuh1jthhhj hNhNubj)}(h**Constants** ``FLUSH_NONE`` do not flush to storage but update data on memory ``FLUSH_PART`` just flush part of data including meta data to storage ``FLUSH_META`` just flush meta data of zone to storage ``FLUSH_ALL`` flush all of zoneh](h)}(h **Constants**h]j)}(hjWh]h Constants}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKhjQubj)}(hhh](j)}(hA``FLUSH_NONE`` do not flush to storage but update data on memory h](j)}(h``FLUSH_NONE``h]j)}(hjvh]h FLUSH_NONE}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKhjpubj)}(hhh]h)}(h1do not flush to storage but update data on memoryh]h1do not flush to storage but update data on memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]uh1jhjhKhjmubj)}(hF``FLUSH_PART`` just flush part of data including meta data to storage h](j)}(h``FLUSH_PART``h]j)}(hjh]h FLUSH_PART}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKhjubj)}(hhh]h)}(h6just flush part of data including meta data to storageh]h6just flush part of data including meta data to storage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjmubj)}(h7``FLUSH_META`` just flush meta data of zone to storage h](j)}(h``FLUSH_META``h]j)}(hjh]h FLUSH_META}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKhjubj)}(hhh]h)}(h'just flush meta data of zone to storageh]h'just flush meta data of zone to storage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjmubj)}(h``FLUSH_ALL`` flush all of zoneh](j)}(h ``FLUSH_ALL``h]j)}(hj!h]h FLUSH_ALL}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKhjubj)}(hhh]h)}(hflush all of zoneh]hflush all of zone}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chKhj7ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj6hKhjmubeh}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubjd)}(hhh]h}(h]h ]h"]h$]h&]entries](jppsz_recovery (C function)c.psz_recoveryhNtauh1jchj hhhNhNubju)}(hhh](jz)}(h*int psz_recovery (struct psz_context *cxt)h]j)}(h)int psz_recovery(struct psz_context *cxt)h](j)}(hinth]hint}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwhhhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chMYubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwhhhjhMYubj)}(h psz_recoveryh]j)}(h psz_recoveryh]h psz_recovery}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjwhhhjhMYubj)}(h(struct psz_context *cxt)h]j)}(hstruct psz_context *cxth](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h psz_contexth]h psz_context}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj reftypej  reftargetjmodnameN classnameNjj)}j]j)}j jsbc.psz_recoveryasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj-)}(hj0h]h*}(hjhhhNhNubah}(h]h ]j9ah"]h$]h&]uh1j,hjubj)}(hcxth]hcxt}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjwhhhjhMYubeh}(h]h ]h"]h$]h&]hhj^uh1jj_j`hjshhhjhMYubah}(h]jnah ](jdjeeh"]h$]h&]jijj)jkhuh1jyhjhMYhjphhubjm)}(hhh]h)}(hrecover data from storageh]hrecover data from storage}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chMRhj8hhubah}(h]h ]h"]h$]h&]uh1jlhjphhhjhMYubeh}(h]h ](j functioneh"]h$]h&]jj jjSjjSjjjuh1jthhhj hNhNubj)}(h**Parameters** ``struct psz_context *cxt`` the context of pstore/zone **Description** recovery means reading data back from storage after rebooting **Return** 0 on success, others on failure.h](h)}(h**Parameters**h]j)}(hj]h]h Parameters}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chMVhjWubj)}(hhh]j)}(h7``struct psz_context *cxt`` the context of pstore/zone h](j)}(h``struct psz_context *cxt``h]j)}(hj|h]hstruct psz_context *cxt}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chMShjvubj)}(hhh]h)}(hthe context of pstore/zoneh]hthe context of pstore/zone}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMShjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhMShjsubah}(h]h ]h"]h$]h&]uh1jhjWubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chMUhjWubh)}(h=recovery means reading data back from storage after rebootingh]h=recovery means reading data back from storage after rebooting}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chMUhjWubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chMWhjWubh)}(h 0 on success, others on failure.h]h 0 on success, others on failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhX/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:227: ./fs/pstore/zone.chMWhjWubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubjd)}(hhh]h}(h]h ]h"]h$]h&]entries](jppstore_zone_info (C struct)c.pstore_zone_infohNtauh1jchj hhhNhNubju)}(hhh](jz)}(hpstore_zone_infoh]j)}(hstruct pstore_zone_infoh](j)}(hjh]hstruct}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKubj)}(h h]h }(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj0hKubj)}(hpstore_zone_infoh]j)}(hjh]hpstore_zone_info}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhj0hKubeh}(h]h ]h"]h$]h&]hhj^uh1jj_j`hjhhhj0hKubah}(h]jah ](jdjeeh"]h$]h&]jijj)jkhuh1jyhj0hKhjhhubjm)}(hhh]h)}(h%pstore/zone back-end driver structureh]h%pstore/zone back-end driver structure}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhK hjbhhubah}(h]h ]h"]h$]h&]uh1jlhjhhhj0hKubeh}(h]h ](j structeh"]h$]h&]jj jj}jj}jjjuh1jthhhj hNhNubj)}(hX**Definition**:: struct pstore_zone_info { struct module *owner; const char *name; unsigned long total_size; unsigned long kmsg_size; int max_reason; unsigned long pmsg_size; unsigned long console_size; unsigned long ftrace_size; pstore_zone_read_op read; pstore_zone_write_op write; pstore_zone_erase_op erase; pstore_zone_write_op panic_write; }; **Members** ``owner`` Module which is responsible for this back-end driver. ``name`` Name of the back-end driver. ``total_size`` The total size in bytes pstore/zone can use. It must be greater than 4096 and be multiple of 4096. ``kmsg_size`` The size of oops/panic zone. Zero means disabled, otherwise, it must be multiple of SECTOR_SIZE(512 Bytes). ``max_reason`` Maximum kmsg dump reason to store. ``pmsg_size`` The size of pmsg zone which is the same as **kmsg_size**. ``console_size`` The size of console zone which is the same as **kmsg_size**. ``ftrace_size`` The size of ftrace zone which is the same as **kmsg_size**. ``read`` The general read operation. Both of the function parameters **size** and **offset** are relative value to storage. On success, the number of bytes should be returned, others mean error. ``write`` The same as **read**, but the following error number: -EBUSY means try to write again later. -ENOMSG means to try next zone. ``erase`` The general erase operation for device with special removing job. Both of the function parameters **size** and **offset** are relative value to storage. Return 0 on success and others on failure. ``panic_write`` The write operation only used for panic case. It's optional if you do not care panic log. The parameters are relative value to storage. On success, the number of bytes should be returned, others excluding -ENOMSG mean error. -ENOMSG means to try next zone.h](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjubh)}(hX{struct pstore_zone_info { struct module *owner; const char *name; unsigned long total_size; unsigned long kmsg_size; int max_reason; unsigned long pmsg_size; unsigned long console_size; unsigned long ftrace_size; pstore_zone_read_op read; pstore_zone_write_op write; pstore_zone_erase_op erase; pstore_zone_write_op panic_write; };h]hX{struct pstore_zone_info { struct module *owner; const char *name; unsigned long total_size; unsigned long kmsg_size; int max_reason; unsigned long pmsg_size; unsigned long console_size; unsigned long ftrace_size; pstore_zone_read_op read; pstore_zone_write_op write; pstore_zone_erase_op erase; pstore_zone_write_op panic_write; };}hjsbah}(h]h ]h"]h$]h&]hhuh1hhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjubh)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhK!hjubj)}(hhh](j)}(h@``owner`` Module which is responsible for this back-end driver. h](j)}(h ``owner``h]j)}(hjh]howner}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjubj)}(hhh]h)}(h5Module which is responsible for this back-end driver.h]h5Module which is responsible for this back-end driver.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h&``name`` Name of the back-end driver. h](j)}(h``name``h]j)}(hj h]hname}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjubj)}(hhh]h)}(hName of the back-end driver.h]hName of the back-end driver.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubj)}(hr``total_size`` The total size in bytes pstore/zone can use. It must be greater than 4096 and be multiple of 4096. h](j)}(h``total_size``h]j)}(hjDh]h total_size}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhj>ubj)}(hhh]h)}(hbThe total size in bytes pstore/zone can use. It must be greater than 4096 and be multiple of 4096.h]hbThe total size in bytes pstore/zone can use. It must be greater than 4096 and be multiple of 4096.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhKhjubj)}(hz``kmsg_size`` The size of oops/panic zone. Zero means disabled, otherwise, it must be multiple of SECTOR_SIZE(512 Bytes). h](j)}(h ``kmsg_size``h]j)}(hj~h]h kmsg_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjxubj)}(hhh]h)}(hkThe size of oops/panic zone. Zero means disabled, otherwise, it must be multiple of SECTOR_SIZE(512 Bytes).h]hkThe size of oops/panic zone. Zero means disabled, otherwise, it must be multiple of SECTOR_SIZE(512 Bytes).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h2``max_reason`` Maximum kmsg dump reason to store. h](j)}(h``max_reason``h]j)}(hjh]h max_reason}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjubj)}(hhh]h)}(h"Maximum kmsg dump reason to store.h]h"Maximum kmsg dump reason to store.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hH``pmsg_size`` The size of pmsg zone which is the same as **kmsg_size**. h](j)}(h ``pmsg_size``h]j)}(hjh]h pmsg_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhjubj)}(hhh]h)}(h9The size of pmsg zone which is the same as **kmsg_size**.h](h+The size of pmsg zone which is the same as }(hj hhhNhNubj)}(h **kmsg_size**h]h kmsg_size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hN``console_size`` The size of console zone which is the same as **kmsg_size**. h](j)}(h``console_size``h]j)}(hj<h]h console_size}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/admin-guide/pstore-blk:230: ./include/linux/pstore_zone.hhKhj6ubj)}(hhh]h)}(h