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/driver-api/tty/consolemodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/zh_TW/driver-api/tty/consolemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/it_IT/driver-api/tty/consolemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/ja_JP/driver-api/tty/consolemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/ko_KR/driver-api/tty/consolemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/pt_BR/driver-api/tty/consolemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/sp_SP/driver-api/tty/consolemodnameN 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/driver-api/tty/console.rsthKubhsection)}(hhh](htitle)}(hConsoleh]hConsole}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhtopic)}(hhh]h bullet_list)}(hhh](h list_item)}(hhh](h paragraph)}(hhh]h reference)}(hhh]hStruct Console}(hhhhhNhNubah}(h]id2ah ]h"]h$]h&]refidstruct-consoleuh1hhhubah}(h]h ]h"]h$]h&]uh1hhhubh)}(hhh]h)}(hhh]h)}(hhh]h)}(hhh]h Internals}(hjhhhNhNubah}(h]id3ah ]h"]h$]h&]refid internalsuh1hhjubah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhubh)}(hhh]h)}(hhh]h)}(hhh]h Struct Consw}(hj@hhhNhNubah}(h]id4ah ]h"]h$]h&]refid struct-conswuh1hhj=ubah}(h]h ]h"]h$]h&]uh1hhj:ubah}(h]h ]h"]h$]h&]uh1hhhubh)}(hhh](h)}(hhh]h)}(hhh]hConsole functions}(hjbhhhNhNubah}(h]id5ah ]h"]h$]h&]refidconsole-functionsuh1hhj_ubah}(h]h ]h"]h$]h&]uh1hhj\ubh)}(hhh]h)}(hhh]h)}(hhh]h)}(hhh]h Internals}(hjhhhNhNubah}(h]id6ah ]h"]h$]h&]refidid1uh1hhj~ubah}(h]h ]h"]h$]h&]uh1hhj{ubah}(h]h ]h"]h$]h&]uh1hhjxubah}(h]h ]h"]h$]h&]uh1hhj\ubeh}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhNhNubah}(h]contentsah ](contentslocaleh"]contentsah$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(hStruct Consoleh]hStruct Console}(hjhhhNhNubah}(h]h ]h"]h$]h&]refidhuh1hhjhhhhhK ubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlecons_flags (C enum) c.cons_flagshNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h cons_flagsh]hdesc_signature_line)}(henum cons_flagsh](hdesc_sig_keyword)}(henumh]henum}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhKubh desc_name)}(h cons_flagsh]h desc_sig_name)}(hjh]h cons_flags}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhƌ add_permalinkuh1jsphinx_line_type declaratorhjhhhjhKubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhKhjhhubh desc_content)}(hhh]h)}(hGeneral console flagsh]hGeneral console flags}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjDhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhKubeh}(h]h ](cenumeh"]h$]h&]domainj_objtypej`desctypej`noindex noindexentrynocontentsentryuh1jhhhjhNhNubh container)}(hX)**Constants** ``CON_PRINTBUFFER`` Used by newly registered consoles to avoid duplicate output of messages that were already shown by boot consoles or read by userspace via syslog() syscall. ``CON_CONSDEV`` Indicates that the console driver is backing /dev/console. ``CON_ENABLED`` Indicates if a console is allowed to print records. If false, the console also will not advance to later records. ``CON_BOOT`` Marks the console driver as early console driver which is used during boot before the real driver becomes available. It will be automatically unregistered when the real console driver is registered unless "keep_bootcon" parameter is used. ``CON_ANYTIME`` A misnomed historical flag which tells the core code that the legacy **console**::write callback can be invoked on a CPU which is marked OFFLINE. That is misleading as it suggests that there is no contextual limit for invoking the callback. The original motivation was readiness of the per-CPU areas. ``CON_BRL`` Indicates a braille device which is exempt from receiving the printk spam for obvious reasons. ``CON_EXTENDED`` The console supports the extended output format of /dev/kmsg which requires a larger output buffer. ``CON_SUSPENDED`` Indicates if a console is suspended. If true, the printing callbacks must not be called. ``CON_NBCON`` Console can operate outside of the legacy style console_lock constraints. ``CON_NBCON_ATOMIC_UNSAFE`` The write_atomic() callback is not safe and is therefore only used by nbcon_atomic_flush_unsafe().h](h)}(h **Constants**h]hstrong)}(hjrh]h Constants}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjpubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjlubhdefinition_list)}(hhh](hdefinition_list_item)}(h``CON_PRINTBUFFER`` Used by newly registered consoles to avoid duplicate output of messages that were already shown by boot consoles or read by userspace via syslog() syscall. h](hterm)}(h``CON_PRINTBUFFER``h]hliteral)}(hjh]hCON_PRINTBUFFER}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubh definition)}(hhh]h)}(hUsed by newly registered consoles to avoid duplicate output of messages that were already shown by boot consoles or read by userspace via syslog() syscall.h]hUsed by newly registered consoles to avoid duplicate output of messages that were already shown by boot consoles or read by userspace via syslog() syscall.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hK``CON_CONSDEV`` Indicates that the console driver is backing /dev/console. h](j)}(h``CON_CONSDEV``h]j)}(hjh]h CON_CONSDEV}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubj)}(hhh]h)}(h:Indicates that the console driver is backing /dev/console.h]h:Indicates that the console driver is backing /dev/console.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h``CON_ENABLED`` Indicates if a console is allowed to print records. If false, the console also will not advance to later records. h](j)}(h``CON_ENABLED``h]j)}(hjh]h CON_ENABLED}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhj ubj)}(hhh]h)}(hqIndicates if a console is allowed to print records. If false, the console also will not advance to later records.h]hqIndicates if a console is allowed to print records. If false, the console also will not advance to later records.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhj'ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj&hKhjubj)}(h``CON_BOOT`` Marks the console driver as early console driver which is used during boot before the real driver becomes available. It will be automatically unregistered when the real console driver is registered unless "keep_bootcon" parameter is used. h](j)}(h ``CON_BOOT``h]j)}(hjKh]hCON_BOOT}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjEubj)}(hhh]h)}(hMarks the console driver as early console driver which is used during boot before the real driver becomes available. It will be automatically unregistered when the real console driver is registered unless "keep_bootcon" parameter is used.h]hMarks the console driver as early console driver which is used during boot before the real driver becomes available. It will be automatically unregistered when the real console driver is registered unless “keep_bootcon” parameter is used.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hKhjubj)}(hX=``CON_ANYTIME`` A misnomed historical flag which tells the core code that the legacy **console**::write callback can be invoked on a CPU which is marked OFFLINE. That is misleading as it suggests that there is no contextual limit for invoking the callback. The original motivation was readiness of the per-CPU areas. h](j)}(h``CON_ANYTIME``h]j)}(hjh]h CON_ANYTIME}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubj)}(hhh]h)}(hX,A misnomed historical flag which tells the core code that the legacy **console**::write callback can be invoked on a CPU which is marked OFFLINE. That is misleading as it suggests that there is no contextual limit for invoking the callback. The original motivation was readiness of the per-CPU areas.h](hEA misnomed historical flag which tells the core code that the legacy }(hjhhhNhNubju)}(h **console**h]hconsole}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh::write callback can be invoked on a CPU which is marked OFFLINE. That is misleading as it suggests that there is no contextual limit for invoking the callback. The original motivation was readiness of the per-CPU areas.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hk``CON_BRL`` Indicates a braille device which is exempt from receiving the printk spam for obvious reasons. h](j)}(h ``CON_BRL``h]j)}(hjh]hCON_BRL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubj)}(hhh]h)}(h^Indicates a braille device which is exempt from receiving the printk spam for obvious reasons.h]h^Indicates a braille device which is exempt from receiving the printk spam for obvious reasons.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hu``CON_EXTENDED`` The console supports the extended output format of /dev/kmsg which requires a larger output buffer. h](j)}(h``CON_EXTENDED``h]j)}(hj h]h CON_EXTENDED}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubj)}(hhh]h)}(hcThe console supports the extended output format of /dev/kmsg which requires a larger output buffer.h]hcThe console supports the extended output format of /dev/kmsg which requires a larger output buffer.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubj)}(hk``CON_SUSPENDED`` Indicates if a console is suspended. If true, the printing callbacks must not be called. h](j)}(h``CON_SUSPENDED``h]j)}(hjEh]h CON_SUSPENDED}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhj?ubj)}(hhh]h)}(hXIndicates if a console is suspended. If true, the printing callbacks must not be called.h]hXIndicates if a console is suspended. If true, the printing callbacks must not be called.}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhKhjubj)}(hX``CON_NBCON`` Console can operate outside of the legacy style console_lock constraints. h](j)}(h ``CON_NBCON``h]j)}(hjh]h CON_NBCON}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjyubj)}(hhh]h)}(hIConsole can operate outside of the legacy style console_lock constraints.h]hIConsole can operate outside of the legacy style console_lock constraints.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h~``CON_NBCON_ATOMIC_UNSAFE`` The write_atomic() callback is not safe and is therefore only used by nbcon_atomic_flush_unsafe().h](j)}(h``CON_NBCON_ATOMIC_UNSAFE``h]j)}(hjh]hCON_NBCON_ATOMIC_UNSAFE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKhjubj)}(hhh]h)}(hbThe write_atomic() callback is not safe and is therefore only used by nbcon_atomic_flush_unsafe().h]hbThe write_atomic() callback is not safe and is therefore only used by nbcon_atomic_flush_unsafe().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jconsole (C struct) c.consolehNtauh1jhjhhhNhNubj)}(hhh](j)}(hconsoleh]j)}(hstruct consoleh](j)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhKubj)}(h h]h }(hj!hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhj hKubj)}(hconsoleh]j)}(hj h]hconsole}(hj3hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj/ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjhhhj hKubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj hhhj hKubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj hKhjhhubjC)}(hhh]h)}(h The console descriptor structureh]h The console descriptor structure}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM:hjRhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhj hKubeh}(h]h ](j_structeh"]h$]h&]jdj_jejmjfjmjgjhjiuh1jhhhjhNhNubjk)}(hX**Definition**:: struct console { char name[16]; void (*write)(struct console *co, const char *s, unsigned int count); int (*read)(struct console *co, char *s, unsigned int count); struct tty_driver *(*device)(struct console *co, int *index); void (*unblank)(void); int (*setup)(struct console *co, char *options); int (*exit)(struct console *co); int (*match)(struct console *co, char *name, int idx, char *options); short flags; short index; int cflag; uint ispeed; uint ospeed; u64 seq; unsigned long dropped; void *data; struct hlist_node node; void (*write_atomic)(struct console *con, struct nbcon_write_context *wctxt); void (*write_thread)(struct console *con, struct nbcon_write_context *wctxt); void (*device_lock)(struct console *con, unsigned long *flags); void (*device_unlock)(struct console *con, unsigned long flags); atomic_t nbcon_state; atomic_long_t nbcon_seq; struct nbcon_context nbcon_device_ctxt; atomic_long_t nbcon_prev_seq; struct printk_buffers *pbufs; struct task_struct *kthread; struct rcuwait rcuwait; struct irq_work irq_work; }; **Members** ``name`` The name of the console driver ``write`` Legacy write callback to output messages (Optional) ``read`` Read callback for console input (Optional) ``device`` The underlying TTY device driver (Optional) ``unblank`` Callback to unblank the console (Optional) ``setup`` Callback for initializing the console (Optional) ``exit`` Callback for teardown of the console (Optional) ``match`` Callback for matching a console (Optional) ``flags`` Console flags. See enum cons_flags ``index`` Console index, e.g. port number ``cflag`` TTY control mode flags ``ispeed`` TTY input speed ``ospeed`` TTY output speed ``seq`` Sequence number of the next ringbuffer record to print ``dropped`` Number of unreported dropped ringbuffer records ``data`` Driver private data ``node`` hlist node for the console list ``write_atomic`` NBCON callback to write out text in any context. (Optional) This callback is called with the console already acquired. However, a higher priority context is allowed to take it over by default. The callback must call nbcon_enter_unsafe() and nbcon_exit_unsafe() around any code where the takeover is not safe, for example, when manipulating the serial port registers. nbcon_enter_unsafe() will fail if the context has lost the console ownership in the meantime. In this case, the callback is no longer allowed to go forward. It must back out immediately and carefully. The buffer content is also no longer trusted since it no longer belongs to the context. The callback should allow the takeover whenever it is safe. It increases the chance to see messages when the system is in trouble. If the driver must reacquire ownership in order to finalize or revert hardware changes, nbcon_reacquire_nobuf() can be used. However, on reacquire the buffer content is no longer available. A reacquire cannot be used to resume printing. The callback can be called from any context (including NMI). Therefore it must avoid usage of any locking and instead rely on the console ownership for synchronization. ``write_thread`` NBCON callback to write out text in task context. This callback must be called only in task context with both device_lock() and the nbcon console acquired with NBCON_PRIO_NORMAL. The same rules for console ownership verification and unsafe sections handling applies as with write_atomic(). The console ownership handling is necessary for synchronization against write_atomic() which is synchronized only via the context. The device_lock() provides the primary serialization for operations on the device. It might be as relaxed (mutex)[*] or as tight (disabled preemption and interrupts) as needed. It allows the kthread to operate in the least restrictive mode[**]. [*] Standalone nbcon_context_try_acquire() is not safe with the preemption enabled, see nbcon_owner_matches(). But it can be safe when always called in the preemptive context under the device_lock(). [**] The device_lock() makes sure that nbcon_context_try_acquire() would never need to spin which is important especially with PREEMPT_RT. ``device_lock`` NBCON callback to begin synchronization with driver code. Console drivers typically must deal with access to the hardware via user input/output (such as an interactive login shell) and output of kernel messages via printk() calls. This callback is called by the printk-subsystem whenever it needs to synchronize with hardware access by the driver. It should be implemented to use whatever synchronization mechanism the driver is using for itself (for example, the port lock for uart serial consoles). The callback is always called from task context. It may use any synchronization method required by the driver. IMPORTANT: The callback MUST disable migration. The console driver may be using a synchronization mechanism that already takes care of this (such as spinlocks). Otherwise this function must explicitly call migrate_disable(). The flags argument is provided as a convenience to the driver. It will be passed again to device_unlock(). It can be ignored if the driver does not need it. ``device_unlock`` NBCON callback to finish synchronization with driver code. It is the counterpart to device_lock(). This callback is always called from task context. It must appropriately re-enable migration (depending on how device_lock() disabled migration). The flags argument is the value of the same variable that was passed to device_lock(). ``nbcon_state`` State for nbcon consoles ``nbcon_seq`` Sequence number of the next record for nbcon to print ``nbcon_device_ctxt`` Context available for non-printing operations ``nbcon_prev_seq`` Seq num the previous nbcon owner was assigned to print ``pbufs`` Pointer to nbcon private buffer ``kthread`` Printer kthread for this console ``rcuwait`` RCU-safe wait object for **kthread** waking ``irq_work`` Defer **kthread** waking to IRQ work contexth](h)}(h**Definition**::h](ju)}(h**Definition**h]h Definition}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjuubh:}(hjuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM>hjqubh literal_block)}(hXstruct console { char name[16]; void (*write)(struct console *co, const char *s, unsigned int count); int (*read)(struct console *co, char *s, unsigned int count); struct tty_driver *(*device)(struct console *co, int *index); void (*unblank)(void); int (*setup)(struct console *co, char *options); int (*exit)(struct console *co); int (*match)(struct console *co, char *name, int idx, char *options); short flags; short index; int cflag; uint ispeed; uint ospeed; u64 seq; unsigned long dropped; void *data; struct hlist_node node; void (*write_atomic)(struct console *con, struct nbcon_write_context *wctxt); void (*write_thread)(struct console *con, struct nbcon_write_context *wctxt); void (*device_lock)(struct console *con, unsigned long *flags); void (*device_unlock)(struct console *con, unsigned long flags); atomic_t nbcon_state; atomic_long_t nbcon_seq; struct nbcon_context nbcon_device_ctxt; atomic_long_t nbcon_prev_seq; struct printk_buffers *pbufs; struct task_struct *kthread; struct rcuwait rcuwait; struct irq_work irq_work; };h]hXstruct console { char name[16]; void (*write)(struct console *co, const char *s, unsigned int count); int (*read)(struct console *co, char *s, unsigned int count); struct tty_driver *(*device)(struct console *co, int *index); void (*unblank)(void); int (*setup)(struct console *co, char *options); int (*exit)(struct console *co); int (*match)(struct console *co, char *name, int idx, char *options); short flags; short index; int cflag; uint ispeed; uint ospeed; u64 seq; unsigned long dropped; void *data; struct hlist_node node; void (*write_atomic)(struct console *con, struct nbcon_write_context *wctxt); void (*write_thread)(struct console *con, struct nbcon_write_context *wctxt); void (*device_lock)(struct console *con, unsigned long *flags); void (*device_unlock)(struct console *con, unsigned long flags); atomic_t nbcon_state; atomic_long_t nbcon_seq; struct nbcon_context nbcon_device_ctxt; atomic_long_t nbcon_prev_seq; struct printk_buffers *pbufs; struct task_struct *kthread; struct rcuwait rcuwait; struct irq_work irq_work; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM@hjqubh)}(h **Members**h]ju)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM`hjqubj)}(hhh](j)}(h(``name`` The name of the console driver h](j)}(h``name``h]j)}(hjh]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM<hjubj)}(hhh]h)}(hThe name of the console driverh]hThe name of the console driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM<hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM<hjubj)}(h>``write`` Legacy write callback to output messages (Optional) h](j)}(h ``write``h]j)}(hjh]hwrite}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM=hjubj)}(hhh]h)}(h3Legacy write callback to output messages (Optional)h]h3Legacy write callback to output messages (Optional)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM=hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM=hjubj)}(h4``read`` Read callback for console input (Optional) h](j)}(h``read``h]j)}(hj6h]hread}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM>hj0ubj)}(hhh]h)}(h*Read callback for console input (Optional)h]h*Read callback for console input (Optional)}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhM>hjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhM>hjubj)}(h7``device`` The underlying TTY device driver (Optional) h](j)}(h ``device``h]j)}(hjoh]hdevice}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjmubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM?hjiubj)}(hhh]h)}(h+The underlying TTY device driver (Optional)h]h+The underlying TTY device driver (Optional)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM?hjubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjhM?hjubj)}(h7``unblank`` Callback to unblank the console (Optional) h](j)}(h ``unblank``h]j)}(hjh]hunblank}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM@hjubj)}(hhh]h)}(h*Callback to unblank the console (Optional)h]h*Callback to unblank the console (Optional)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM@hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM@hjubj)}(h;``setup`` Callback for initializing the console (Optional) h](j)}(h ``setup``h]j)}(hjh]hsetup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMAhjubj)}(hhh]h)}(h0Callback for initializing the console (Optional)h]h0Callback for initializing the console (Optional)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMAhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMAhjubj)}(h9``exit`` Callback for teardown of the console (Optional) h](j)}(h``exit``h]j)}(hjh]hexit}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMBhjubj)}(hhh]h)}(h/Callback for teardown of the console (Optional)h]h/Callback for teardown of the console (Optional)}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMBhj0ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj/hMBhjubj)}(h5``match`` Callback for matching a console (Optional) h](j)}(h ``match``h]j)}(hjSh]hmatch}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMChjMubj)}(hhh]h)}(h*Callback for matching a console (Optional)h]h*Callback for matching a console (Optional)}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMChjiubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjhhMChjubj)}(h-``flags`` Console flags. See enum cons_flags h](j)}(h ``flags``h]j)}(hjh]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMDhjubj)}(hhh]h)}(h"Console flags. See enum cons_flagsh]h"Console flags. See enum cons_flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMDhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMDhjubj)}(h*``index`` Console index, e.g. port number h](j)}(h ``index``h]j)}(hjh]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMEhjubj)}(hhh]h)}(hConsole index, e.g. port numberh]hConsole index, e.g. port number}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMEhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMEhjubj)}(h!``cflag`` TTY control mode flags h](j)}(h ``cflag``h]j)}(hjh]hcflag}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMFhjubj)}(hhh]h)}(hTTY control mode flagsh]hTTY control mode flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMFhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMFhjubj)}(h``ispeed`` TTY input speed h](j)}(h ``ispeed``h]j)}(hj7h]hispeed}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMGhj1ubj)}(hhh]h)}(hTTY input speedh]hTTY input speed}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhMGhjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhMGhjubj)}(h``ospeed`` TTY output speed h](j)}(h ``ospeed``h]j)}(hjph]hospeed}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMHhjjubj)}(hhh]h)}(hTTY output speedh]hTTY output speed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMHhjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhMHhjubj)}(h?``seq`` Sequence number of the next ringbuffer record to print h](j)}(h``seq``h]j)}(hjh]hseq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMIhjubj)}(hhh]h)}(h6Sequence number of the next ringbuffer record to printh]h6Sequence number of the next ringbuffer record to print}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMIhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMIhjubj)}(h<``dropped`` Number of unreported dropped ringbuffer records h](j)}(h ``dropped``h]j)}(hjh]hdropped}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMJhjubj)}(hhh]h)}(h/Number of unreported dropped ringbuffer recordsh]h/Number of unreported dropped ringbuffer records}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMJhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMJhjubj)}(h``data`` Driver private data h](j)}(h``data``h]j)}(hj h]hdata}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMKhj ubj)}(hhh]h)}(hDriver private datah]hDriver private data}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0 hMKhj1 ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj0 hMKhjubj)}(h)``node`` hlist node for the console list h](j)}(h``node``h]j)}(hjT h]hnode}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjR ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMLhjN ubj)}(hhh]h)}(hhlist node for the console listh]hhlist node for the console list}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1hhji hMLhjj ubah}(h]h ]h"]h$]h&]uh1jhjN ubeh}(h]h ]h"]h$]h&]uh1jhji hMLhjubj)}(hX``write_atomic`` NBCON callback to write out text in any context. (Optional) This callback is called with the console already acquired. However, a higher priority context is allowed to take it over by default. The callback must call nbcon_enter_unsafe() and nbcon_exit_unsafe() around any code where the takeover is not safe, for example, when manipulating the serial port registers. nbcon_enter_unsafe() will fail if the context has lost the console ownership in the meantime. In this case, the callback is no longer allowed to go forward. It must back out immediately and carefully. The buffer content is also no longer trusted since it no longer belongs to the context. The callback should allow the takeover whenever it is safe. It increases the chance to see messages when the system is in trouble. If the driver must reacquire ownership in order to finalize or revert hardware changes, nbcon_reacquire_nobuf() can be used. However, on reacquire the buffer content is no longer available. A reacquire cannot be used to resume printing. The callback can be called from any context (including NMI). Therefore it must avoid usage of any locking and instead rely on the console ownership for synchronization. h](j)}(h``write_atomic``h]j)}(hj h]h write_atomic}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubj)}(hhh](h)}(h;NBCON callback to write out text in any context. (Optional)h]h;NBCON callback to write out text in any context. (Optional)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMmhj ubh)}(hThis callback is called with the console already acquired. However, a higher priority context is allowed to take it over by default.h]hThis callback is called with the console already acquired. However, a higher priority context is allowed to take it over by default.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMohj ubh)}(hThe callback must call nbcon_enter_unsafe() and nbcon_exit_unsafe() around any code where the takeover is not safe, for example, when manipulating the serial port registers.h]hThe callback must call nbcon_enter_unsafe() and nbcon_exit_unsafe() around any code where the takeover is not safe, for example, when manipulating the serial port registers.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMrhj ubh)}(hX nbcon_enter_unsafe() will fail if the context has lost the console ownership in the meantime. In this case, the callback is no longer allowed to go forward. It must back out immediately and carefully. The buffer content is also no longer trusted since it no longer belongs to the context.h]hX nbcon_enter_unsafe() will fail if the context has lost the console ownership in the meantime. In this case, the callback is no longer allowed to go forward. It must back out immediately and carefully. The buffer content is also no longer trusted since it no longer belongs to the context.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMvhj ubh)}(hXoThe callback should allow the takeover whenever it is safe. It increases the chance to see messages when the system is in trouble. If the driver must reacquire ownership in order to finalize or revert hardware changes, nbcon_reacquire_nobuf() can be used. However, on reacquire the buffer content is no longer available. A reacquire cannot be used to resume printing.h]hXoThe callback should allow the takeover whenever it is safe. It increases the chance to see messages when the system is in trouble. If the driver must reacquire ownership in order to finalize or revert hardware changes, nbcon_reacquire_nobuf() can be used. However, on reacquire the buffer content is no longer available. A reacquire cannot be used to resume printing.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhM|hj ubh)}(hThe callback can be called from any context (including NMI). Therefore it must avoid usage of any locking and instead rely on the console ownership for synchronization.h]hThe callback can be called from any context (including NMI). Therefore it must avoid usage of any locking and instead rely on the console ownership for synchronization.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(hX``write_thread`` NBCON callback to write out text in task context. This callback must be called only in task context with both device_lock() and the nbcon console acquired with NBCON_PRIO_NORMAL. The same rules for console ownership verification and unsafe sections handling applies as with write_atomic(). The console ownership handling is necessary for synchronization against write_atomic() which is synchronized only via the context. The device_lock() provides the primary serialization for operations on the device. It might be as relaxed (mutex)[*] or as tight (disabled preemption and interrupts) as needed. It allows the kthread to operate in the least restrictive mode[**]. [*] Standalone nbcon_context_try_acquire() is not safe with the preemption enabled, see nbcon_owner_matches(). But it can be safe when always called in the preemptive context under the device_lock(). [**] The device_lock() makes sure that nbcon_context_try_acquire() would never need to spin which is important especially with PREEMPT_RT. h](j)}(h``write_thread``h]j)}(hj h]h write_thread}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubj)}(hhh](h)}(h1NBCON callback to write out text in task context.h]h1NBCON callback to write out text in task context.}(hj+ hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj( ubh)}(hThis callback must be called only in task context with both device_lock() and the nbcon console acquired with NBCON_PRIO_NORMAL.h]hThis callback must be called only in task context with both device_lock() and the nbcon console acquired with NBCON_PRIO_NORMAL.}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj( ubh)}(hnThe same rules for console ownership verification and unsafe sections handling applies as with write_atomic().h]hnThe same rules for console ownership verification and unsafe sections handling applies as with write_atomic().}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj( ubh)}(hThe console ownership handling is necessary for synchronization against write_atomic() which is synchronized only via the context.h]hThe console ownership handling is necessary for synchronization against write_atomic() which is synchronized only via the context.}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj( ubh)}(hThe device_lock() provides the primary serialization for operations on the device. It might be as relaxed (mutex)[*] or as tight (disabled preemption and interrupts) as needed. It allows the kthread to operate in the least restrictive mode[**].h]hThe device_lock() provides the primary serialization for operations on the device. It might be as relaxed (mutex)[*] or as tight (disabled preemption and interrupts) as needed. It allows the kthread to operate in the least restrictive mode[**].}(hjg hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj( ubj)}(hhh](j)}(h[*] Standalone nbcon_context_try_acquire() is not safe with the preemption enabled, see nbcon_owner_matches(). But it can be safe when always called in the preemptive context under the device_lock(). h](j)}(h;[*] Standalone nbcon_context_try_acquire() is not safe withh]h;[*] Standalone nbcon_context_try_acquire() is not safe with}(hj} hhhNhNubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhjy ubj)}(hhh]h)}(hthe preemption enabled, see nbcon_owner_matches(). But it can be safe when always called in the preemptive context under the device_lock().h]hthe preemption enabled, see nbcon_owner_matches(). But it can be safe when always called in the preemptive context under the device_lock().}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubah}(h]h ]h"]h$]h&]uh1jhjy ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjv ubj)}(h[**] The device_lock() makes sure that nbcon_context_try_acquire() would never need to spin which is important especially with PREEMPT_RT. h](j)}(hB[**] The device_lock() makes sure that nbcon_context_try_acquire()h]hB[**] The device_lock() makes sure that nbcon_context_try_acquire()}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj' hMhj ubj)}(hhh]h)}(hGwould never need to spin which is important especially with PREEMPT_RT.h]hGwould never need to spin which is important especially with PREEMPT_RT.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj' hMhjv ubeh}(h]h ]h"]h$]h&]uh1jhj( ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj' hMhjubj)}(hX``device_lock`` NBCON callback to begin synchronization with driver code. Console drivers typically must deal with access to the hardware via user input/output (such as an interactive login shell) and output of kernel messages via printk() calls. This callback is called by the printk-subsystem whenever it needs to synchronize with hardware access by the driver. It should be implemented to use whatever synchronization mechanism the driver is using for itself (for example, the port lock for uart serial consoles). The callback is always called from task context. It may use any synchronization method required by the driver. IMPORTANT: The callback MUST disable migration. The console driver may be using a synchronization mechanism that already takes care of this (such as spinlocks). Otherwise this function must explicitly call migrate_disable(). The flags argument is provided as a convenience to the driver. It will be passed again to device_unlock(). It can be ignored if the driver does not need it. h](j)}(h``device_lock``h]j)}(hj h]h device_lock}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubj)}(hhh](h)}(h9NBCON callback to begin synchronization with driver code.h]h9NBCON callback to begin synchronization with driver code.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubh)}(hXConsole drivers typically must deal with access to the hardware via user input/output (such as an interactive login shell) and output of kernel messages via printk() calls. This callback is called by the printk-subsystem whenever it needs to synchronize with hardware access by the driver. It should be implemented to use whatever synchronization mechanism the driver is using for itself (for example, the port lock for uart serial consoles).h]hXConsole drivers typically must deal with access to the hardware via user input/output (such as an interactive login shell) and output of kernel messages via printk() calls. This callback is called by the printk-subsystem whenever it needs to synchronize with hardware access by the driver. It should be implemented to use whatever synchronization mechanism the driver is using for itself (for example, the port lock for uart serial consoles).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubh)}(hnThe callback is always called from task context. It may use any synchronization method required by the driver.h]hnThe callback is always called from task context. It may use any synchronization method required by the driver.}(hj) hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubj)}(hhh]j)}(hIMPORTANT: The callback MUST disable migration. The console driver may be using a synchronization mechanism that already takes care of this (such as spinlocks). Otherwise this function must explicitly call migrate_disable(). h](j)}(hBIMPORTANT: The callback MUST disable migration. The console driverh]hBIMPORTANT: The callback MUST disable migration. The console driver}(hj? hhhNhNubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj; ubj)}(hhh]h)}(hmay be using a synchronization mechanism that already takes care of this (such as spinlocks). Otherwise this function must explicitly call migrate_disable().h]hmay be using a synchronization mechanism that already takes care of this (such as spinlocks). Otherwise this function must explicitly call migrate_disable().}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhjN ubah}(h]h ]h"]h$]h&]uh1jhj; ubeh}(h]h ]h"]h$]h&]uh1jhjM hMhj8 ubah}(h]h ]h"]h$]h&]uh1jhj ubh)}(hThe flags argument is provided as a convenience to the driver. It will be passed again to device_unlock(). It can be ignored if the driver does not need it.h]hThe flags argument is provided as a convenience to the driver. It will be passed again to device_unlock(). It can be ignored if the driver does not need it.}(hjr hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(hX```device_unlock`` NBCON callback to finish synchronization with driver code. It is the counterpart to device_lock(). This callback is always called from task context. It must appropriately re-enable migration (depending on how device_lock() disabled migration). The flags argument is the value of the same variable that was passed to device_lock(). h](j)}(h``device_unlock``h]j)}(hj h]h device_unlock}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubj)}(hhh](h)}(h:NBCON callback to finish synchronization with driver code.h]h:NBCON callback to finish synchronization with driver code.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubh)}(h'It is the counterpart to device_lock().h]h'It is the counterpart to device_lock().}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubh)}(hThis callback is always called from task context. It must appropriately re-enable migration (depending on how device_lock() disabled migration).h]hThis callback is always called from task context. It must appropriately re-enable migration (depending on how device_lock() disabled migration).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubh)}(hVThe flags argument is the value of the same variable that was passed to device_lock().h]hVThe flags argument is the value of the same variable that was passed to device_lock().}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhjubj)}(h)``nbcon_state`` State for nbcon consoles h](j)}(h``nbcon_state``h]j)}(hj h]h nbcon_state}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMNhj ubj)}(hhh]h)}(hState for nbcon consolesh]hState for nbcon consoles}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMNhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMNhjubj)}(hD``nbcon_seq`` Sequence number of the next record for nbcon to print h](j)}(h ``nbcon_seq``h]j)}(hj3 h]h nbcon_seq}(hj5 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1 ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMOhj- ubj)}(hhh]h)}(h5Sequence number of the next record for nbcon to printh]h5Sequence number of the next record for nbcon to print}(hjL hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjH hMOhjI ubah}(h]h ]h"]h$]h&]uh1jhj- ubeh}(h]h ]h"]h$]h&]uh1jhjH hMOhjubj)}(hD``nbcon_device_ctxt`` Context available for non-printing operations h](j)}(h``nbcon_device_ctxt``h]j)}(hjl h]hnbcon_device_ctxt}(hjn hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMPhjf ubj)}(hhh]h)}(h-Context available for non-printing operationsh]h-Context available for non-printing operations}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMPhj ubah}(h]h ]h"]h$]h&]uh1jhjf ubeh}(h]h ]h"]h$]h&]uh1jhj hMPhjubj)}(hJ``nbcon_prev_seq`` Seq num the previous nbcon owner was assigned to print h](j)}(h``nbcon_prev_seq``h]j)}(hj h]hnbcon_prev_seq}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMQhj ubj)}(hhh]h)}(h6Seq num the previous nbcon owner was assigned to printh]h6Seq num the previous nbcon owner was assigned to print}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMQhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMQhjubj)}(h*``pbufs`` Pointer to nbcon private buffer h](j)}(h ``pbufs``h]j)}(hj h]hpbufs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMRhj ubj)}(hhh]h)}(hPointer to nbcon private bufferh]hPointer to nbcon private buffer}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMRhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMRhjubj)}(h-``kthread`` Printer kthread for this console h](j)}(h ``kthread``h]j)}(hj h]hkthread}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMShj ubj)}(hhh]h)}(h Printer kthread for this consoleh]h Printer kthread for this console}(hj0 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj, hMShj- ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj, hMShjubj)}(h8``rcuwait`` RCU-safe wait object for **kthread** waking h](j)}(h ``rcuwait``h]j)}(hjP h]hrcuwait}(hjR hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjN ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMThjJ ubj)}(hhh]h)}(h+RCU-safe wait object for **kthread** wakingh](hRCU-safe wait object for }(hji hhhNhNubju)}(h **kthread**h]hkthread}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1jthji ubh waking}(hji hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhje hMThjf ubah}(h]h ]h"]h$]h&]uh1jhjJ ubeh}(h]h ]h"]h$]h&]uh1jhje hMThjubj)}(h9``irq_work`` Defer **kthread** waking to IRQ work contexth](j)}(h ``irq_work``h]j)}(hj h]hirq_work}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMThj ubj)}(hhh]h)}(h,Defer **kthread** waking to IRQ work contexth](hDefer }(hj hhhNhNubju)}(h **kthread**h]hkthread}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj ubh waking to IRQ work context}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:12: ./include/linux/console.hhMUhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMThjubeh}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubh)}(hhh](h)}(h Internalsh]h Internals}(hj hhhNhNubah}(h]h ]h"]h$]h&]jjuh1hhj hhhhhKubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jnbcon_state (C struct) c.nbcon_statehNtauh1jhj hhhNhNubj)}(hhh](j)}(h nbcon_stateh]j)}(hstruct nbcon_stateh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKubj)}(h h]h }(hj&hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhj%hKubj)}(h nbcon_stateh]j)}(hjh]h nbcon_state}(hj8hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj4ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjhhhj%hKubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjhhhj%hKubah}(h]j ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj%hKhj hhubjC)}(hhh]h)}(h console state for nbcon consolesh]h console state for nbcon consoles}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjWhhubah}(h]h ]h"]h$]h&]uh1jBhj hhhj%hKubeh}(h]h ](j_structeh"]h$]h&]jdj_jejrjfjrjgjhjiuh1jhhhj hNhNubjk)}(hX`**Definition**:: struct nbcon_state { union { unsigned int atom; struct { unsigned int prio : 2; unsigned int req_prio : 2; unsigned int unsafe : 1; unsigned int unsafe_takeover : 1; unsigned int cpu : 24; }; }; }; **Members** ``{unnamed_union}`` anonymous ``atom`` Compound of the state fields for atomic operations ``{unnamed_struct}`` anonymous ``prio`` The priority of the current owner ``req_prio`` The priority of a handover request ``unsafe`` Console is busy in a non takeover region ``unsafe_takeover`` A hostile takeover in an unsafe state happened in the past. The console cannot be safe until re-initialized. ``cpu`` The CPU on which the owner runsh](h)}(h**Definition**::h](ju)}(h**Definition**h]h Definition}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjzubh:}(hjzhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjvubj)}(hX^struct nbcon_state { union { unsigned int atom; struct { unsigned int prio : 2; unsigned int req_prio : 2; unsigned int unsafe : 1; unsigned int unsafe_takeover : 1; unsigned int cpu : 24; }; }; };h]hX^struct nbcon_state { union { unsigned int atom; struct { unsigned int prio : 2; unsigned int req_prio : 2; unsigned int unsafe : 1; unsigned int unsafe_takeover : 1; unsigned int cpu : 24; }; }; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjvubh)}(h **Members**h]ju)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjvubj)}(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/driver-api/tty/console:18: ./include/linux/console.hhKhjubj)}(hhh]h)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h<``atom`` Compound of the state fields for atomic operations h](j)}(h``atom``h]j)}(hjh]hatom}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjubj)}(hhh]h)}(h2Compound of the state fields for atomic operationsh]h2Compound of the state fields for atomic operations}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h``{unnamed_struct}`` anonymous h](j)}(h``{unnamed_struct}``h]j)}(hj9h]h{unnamed_struct}}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj3ubj)}(hhh]h)}(h anonymoush]h anonymous}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhKhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhKhjubj)}(h+``prio`` The priority of the current owner h](j)}(h``prio``h]j)}(hjrh]hprio}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjlubj)}(hhh]h)}(h!The priority of the current ownerh]h!The priority of the current owner}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h0``req_prio`` The priority of a handover request h](j)}(h ``req_prio``h]j)}(hjh]hreq_prio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjubj)}(hhh]h)}(h"The priority of a handover requesth]h"The priority of a handover request}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h4``unsafe`` Console is busy in a non takeover region h](j)}(h ``unsafe``h]j)}(hjh]hunsafe}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjubj)}(hhh]h)}(h(Console is busy in a non takeover regionh]h(Console is busy in a non takeover region}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h``unsafe_takeover`` A hostile takeover in an unsafe state happened in the past. The console cannot be safe until re-initialized. h](j)}(h``unsafe_takeover``h]j)}(hjh]hunsafe_takeover}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjubj)}(hhh]h)}(hlA hostile takeover in an unsafe state happened in the past. The console cannot be safe until re-initialized.h]hlA hostile takeover in an unsafe state happened in the past. The console cannot be safe until re-initialized.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj3ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj2hKhjubj)}(h'``cpu`` The CPU on which the owner runsh](j)}(h``cpu``h]j)}(hjWh]hcpu}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjQubj)}(hhh]h)}(hThe CPU on which the owner runsh]hThe CPU on which the owner runs}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhKhjubeh}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj hhhNhNubh)}(h**Description**h]ju)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj hhubh)}(hnTo be used for reading and preparing of the value stored in the nbcon state variable **console**::nbcon_state.h](hUTo be used for reading and preparing of the value stored in the nbcon state variable }(hjhhhNhNubju)}(h **console**h]hconsole}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh::nbcon_state.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj hhubh)}(hThe **prio** and **req_prio** fields are particularly important to allow spin-waiting to timeout and give up without the risk of a waiter being assigned the lock after giving up.h](hThe }(hjhhhNhNubju)}(h**prio**h]hprio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh and }(hjhhhNhNubju)}(h **req_prio**h]hreq_prio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh fields are particularly important to allow spin-waiting to timeout and give up without the risk of a waiter being assigned the lock after giving up.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj hhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jnbcon_prio (C enum) c.nbcon_priohNtauh1jhj hhhNhNubj)}(hhh](j)}(h nbcon_prioh]j)}(henum nbcon_prioh](j)}(hjh]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKubj)}(h h]h }(hj+hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhj*hKubj)}(h nbcon_prioh]j)}(hjh]h nbcon_prio}(hj=hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj9ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjhhhj*hKubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjhhhj*hKubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj*hKhjhhubjC)}(hhh]h)}(h)console owner priority for nbcon consolesh]h)console owner priority for nbcon consoles}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj\hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhj*hKubeh}(h]h ](j_enumeh"]h$]h&]jdj_jejwjfjwjgjhjiuh1jhhhj hNhNubjk)}(h**Constants** ``NBCON_PRIO_NONE`` Unused ``NBCON_PRIO_NORMAL`` Normal (non-emergency) usage ``NBCON_PRIO_EMERGENCY`` Emergency output (WARN/OOPS...) ``NBCON_PRIO_PANIC`` Panic output ``NBCON_PRIO_MAX`` The number of priority levelsh](h)}(h **Constants**h]ju)}(hjh]h Constants}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj{ubj)}(hhh](j)}(h``NBCON_PRIO_NONE`` Unused h](j)}(h``NBCON_PRIO_NONE``h]j)}(hjh]hNBCON_PRIO_NONE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjubj)}(hhh]h)}(hUnusedh]hUnused}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h3``NBCON_PRIO_NORMAL`` Normal (non-emergency) usage h](j)}(h``NBCON_PRIO_NORMAL``h]j)}(hjh]hNBCON_PRIO_NORMAL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhjubj)}(hhh]h)}(hNormal (non-emergency) usageh]hNormal (non-emergency) usage}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h9``NBCON_PRIO_EMERGENCY`` Emergency output (WARN/OOPS...) h](j)}(h``NBCON_PRIO_EMERGENCY``h]j)}(hjh]hNBCON_PRIO_EMERGENCY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj ubj)}(hhh]h)}(hEmergency output (WARN/OOPS...)h]hEmergency output (WARN/OOPS...)}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hKhj(ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj'hKhjubj)}(h"``NBCON_PRIO_PANIC`` Panic output h](j)}(h``NBCON_PRIO_PANIC``h]j)}(hjKh]hNBCON_PRIO_PANIC}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjEubj)}(hhh]h)}(h Panic outputh]h Panic output}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjubj)}(h0``NBCON_PRIO_MAX`` The number of priority levelsh](j)}(h``NBCON_PRIO_MAX``h]j)}(hjh]hNBCON_PRIO_MAX}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhj~ubj)}(hhh]h)}(hThe number of priority levelsh]hThe number of priority levels}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj hhhNhNubh)}(h**Description**h]ju)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhj hhubh)}(hA higher priority context can takeover the console when it is in the safe state. The final attempt to flush consoles in panic() can be allowed to do so even in an unsafe state (Hope and pray).h]hA higher priority context can takeover the console when it is in the safe state. The final attempt to flush consoles in panic() can be allowed to do so even in an unsafe state (Hope and pray).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKhj hhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jnbcon_context (C struct)c.nbcon_contexthNtauh1jhj hhhNhNubj)}(hhh](j)}(h nbcon_contexth]j)}(hstruct nbcon_contexth](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhKubj)}(h nbcon_contexth]j)}(hjh]h nbcon_context}(hj%hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj!ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjhhhjhKubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhKhjhhubjC)}(hhh]h)}(h#Context for console acquire/releaseh]h#Context for console acquire/release}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjDhhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhKubeh}(h]h ](j_structeh"]h$]h&]jdj_jej_jfj_jgjhjiuh1jhhhj hNhNubjk)}(hX<**Definition**:: struct nbcon_context { struct console *console; unsigned int spinwait_max_us; enum nbcon_prio prio; unsigned int allow_unsafe_takeover : 1; unsigned int backlog : 1; struct printk_buffers *pbufs; u64 seq; }; **Members** ``console`` The associated console ``spinwait_max_us`` Limit for spin-wait acquire ``prio`` Priority of the context ``allow_unsafe_takeover`` Allow performing takeover even if unsafe. Can be used only with NBCON_PRIO_PANIC **prio**. It might cause a system freeze when the console is used later. ``backlog`` Ringbuffer has pending records ``pbufs`` Pointer to the text buffer for this context ``seq`` The sequence number to print for this contexth](h)}(h**Definition**::h](ju)}(h**Definition**h]h Definition}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjgubh:}(hjghhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM hjcubj)}(hX1struct nbcon_context { struct console *console; unsigned int spinwait_max_us; enum nbcon_prio prio; unsigned int allow_unsafe_takeover : 1; unsigned int backlog : 1; struct printk_buffers *pbufs; u64 seq; };h]hX1struct nbcon_context { struct console *console; unsigned int spinwait_max_us; enum nbcon_prio prio; unsigned int allow_unsafe_takeover : 1; unsigned int backlog : 1; struct printk_buffers *pbufs; u64 seq; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjcubh)}(h **Members**h]ju)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjcubj)}(hhh](j)}(h#``console`` The associated console h](j)}(h ``console``h]j)}(hjh]hconsole}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM hjubj)}(hhh]h)}(hThe associated consoleh]hThe associated console}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h0``spinwait_max_us`` Limit for spin-wait acquire h](j)}(h``spinwait_max_us``h]j)}(hjh]hspinwait_max_us}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM hjubj)}(hhh]h)}(hLimit for spin-wait acquireh]hLimit for spin-wait acquire}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h!``prio`` Priority of the context h](j)}(h``prio``h]j)}(hj&h]hprio}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM hj ubj)}(hhh]h)}(hPriority of the contexth]hPriority of the context}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hM hj<ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj;hM hjubj)}(h``allow_unsafe_takeover`` Allow performing takeover even if unsafe. Can be used only with NBCON_PRIO_PANIC **prio**. It might cause a system freeze when the console is used later. h](j)}(h``allow_unsafe_takeover``h]j)}(hj_h]hallow_unsafe_takeover}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjYubj)}(hhh]h)}(hAllow performing takeover even if unsafe. Can be used only with NBCON_PRIO_PANIC **prio**. It might cause a system freeze when the console is used later.h](hQAllow performing takeover even if unsafe. Can be used only with NBCON_PRIO_PANIC }(hjxhhhNhNubju)}(h**prio**h]hprio}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjxubh@. It might cause a system freeze when the console is used later.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM hjuubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjthMhjubj)}(h+``backlog`` Ringbuffer has pending records h](j)}(h ``backlog``h]j)}(hjh]hbacklog}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjubj)}(hhh]h)}(hRingbuffer has pending recordsh]hRingbuffer has pending records}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h6``pbufs`` Pointer to the text buffer for this context h](j)}(h ``pbufs``h]j)}(hjh]hpbufs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjubj)}(hhh]h)}(h+Pointer to the text buffer for this contexth]h+Pointer to the text buffer for this context}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h5``seq`` The sequence number to print for this contexth](j)}(h``seq``h]j)}(hjh]hseq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhjubj)}(hhh]h)}(h-The sequence number to print for this contexth]h-The sequence number to print for this context}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMhj3ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj2hMhjubeh}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jnbcon_write_context (C struct)c.nbcon_write_contexthNtauh1jhj hhhNhNubj)}(hhh](j)}(hnbcon_write_contexth]j)}(hstruct nbcon_write_contexth](j)}(hjh]hstruct}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjshhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjshhhjhMubj)}(hnbcon_write_contexth]j)}(hjqh]hnbcon_write_context}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjshhhjhMubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjohhhjhMubah}(h]jjah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhMhjlhhubjC)}(hhh]h)}(h+Context handed to the nbcon write callbacksh]h+Context handed to the nbcon write callbacks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM$hjhhubah}(h]h ]h"]h$]h&]uh1jBhjlhhhjhMubeh}(h]h ](j_structeh"]h$]h&]jdj_jejjfjjgjhjiuh1jhhhj hNhNubjk)}(hX**Definition**:: struct nbcon_write_context { struct nbcon_context ctxt; char *outbuf; unsigned int len; bool unsafe_takeover; #ifdef CONFIG_PRINTK_EXECUTION_CTX; int cpu; pid_t pid; char comm[TASK_COMM_LEN]; #endif; }; **Members** ``ctxt`` The core console context ``outbuf`` Pointer to the text buffer for output ``len`` Length to write ``unsafe_takeover`` If a hostile takeover in an unsafe state has occurred ``cpu`` CPU on which the message was generated ``pid`` PID of the task that generated the message ``comm`` Name of the task that generated the messageh](h)}(h**Definition**::h](ju)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM(hjubj)}(hstruct nbcon_write_context { struct nbcon_context ctxt; char *outbuf; unsigned int len; bool unsafe_takeover; #ifdef CONFIG_PRINTK_EXECUTION_CTX; int cpu; pid_t pid; char comm[TASK_COMM_LEN]; #endif; };h]hstruct nbcon_write_context { struct nbcon_context ctxt; char *outbuf; unsigned int len; bool unsafe_takeover; #ifdef CONFIG_PRINTK_EXECUTION_CTX; int cpu; pid_t pid; char comm[TASK_COMM_LEN]; #endif; };}hjsbah}(h]h ]h"]h$]h&]hhuh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM*hjubh)}(h **Members**h]ju)}(hjh]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM6hjubj)}(hhh](j)}(h"``ctxt`` The core console context h](j)}(h``ctxt``h]j)}(hj&h]hctxt}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM&hj ubj)}(hhh]h)}(hThe core console contexth]hThe core console context}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hM&hj<ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj;hM&hjubj)}(h1``outbuf`` Pointer to the text buffer for output h](j)}(h ``outbuf``h]j)}(hj_h]houtbuf}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM'hjYubj)}(hhh]h)}(h%Pointer to the text buffer for outputh]h%Pointer to the text buffer for output}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthM'hjuubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjthM'hjubj)}(h``len`` Length to write h](j)}(h``len``h]j)}(hjh]hlen}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM(hjubj)}(hhh]h)}(hLength to writeh]hLength to write}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM(hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM(hjubj)}(hJ``unsafe_takeover`` If a hostile takeover in an unsafe state has occurred h](j)}(h``unsafe_takeover``h]j)}(hjh]hunsafe_takeover}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM)hjubj)}(hhh]h)}(h5If a hostile takeover in an unsafe state has occurredh]h5If a hostile takeover in an unsafe state has occurred}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM)hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM)hjubj)}(h/``cpu`` CPU on which the message was generated h](j)}(h``cpu``h]j)}(hj h]hcpu}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM*hjubj)}(hhh]h)}(h&CPU on which the message was generatedh]h&CPU on which the message was generated}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM*hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM*hjubj)}(h3``pid`` PID of the task that generated the message h](j)}(h``pid``h]j)}(hjCh]hpid}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM+hj=ubj)}(hhh]h)}(h*PID of the task that generated the messageh]h*PID of the task that generated the message}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhM+hjYubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhjXhM+hjubj)}(h4``comm`` Name of the task that generated the messageh](j)}(h``comm``h]j)}(hj|h]hcomm}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM+hjvubj)}(hhh]h)}(h+Name of the task that generated the messageh]h+Name of the task that generated the message}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:18: ./include/linux/console.hhM,hjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjhM+hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj hhhNhNubeh}(h]j!ah ]h"]h$] internalsah&]uh1hhjhhhhhK referencedKubeh}(h]jah ]h"]struct consoleah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(h Struct Conswh]h Struct Consw}(hjhhhNhNubah}(h]h ]h"]h$]h&]jjIuh1hhjhhhhhKubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jconsw (C struct)c.conswhNtauh1jhjhhhNhNubj)}(hhh](j)}(hconswh]j)}(h struct conswh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhKubj)}(hconswh]j)}(hjh]hconsw}(hjhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjhhhjhKubah}(h]jah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjhKhjhhubjC)}(hhh]h)}(hcallbacks for consolesh]hcallbacks for consoles}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK)hj5hhubah}(h]h ]h"]h$]h&]uh1jBhjhhhjhKubeh}(h]h ](j_structeh"]h$]h&]jdj_jejPjfjPjgjhjiuh1jhhhjhNhNubjk)}(hX[**Definition**:: struct consw { struct module *owner; const char *(*con_startup)(void); void (*con_init)(struct vc_data *vc, bool init); void (*con_deinit)(struct vc_data *vc); void (*con_clear)(struct vc_data *vc, unsigned int y, unsigned int x, unsigned int count); void (*con_putc)(struct vc_data *vc, u16 ca, unsigned int y, unsigned int x); void (*con_putcs)(struct vc_data *vc, const u16 *s, unsigned int count, unsigned int ypos, unsigned int xpos); void (*con_cursor)(struct vc_data *vc, bool enable); bool (*con_scroll)(struct vc_data *vc, unsigned int top, unsigned int bottom, enum con_scroll dir, unsigned int lines); bool (*con_switch)(struct vc_data *vc); bool (*con_blank)(struct vc_data *vc, enum vesa_blank_mode blank, bool mode_switch); bool (*con_unblank)(struct vc_data *vc, bool mode_switch); int (*con_font_set)(struct vc_data *vc, const struct console_font *font, unsigned int vpitch, unsigned int flags); int (*con_font_get)(struct vc_data *vc, struct console_font *font, unsigned int vpitch); int (*con_font_default)(struct vc_data *vc, struct console_font *font, const char *name); int (*con_resize)(struct vc_data *vc, unsigned int width, unsigned int height, bool from_user); void (*con_set_palette)(struct vc_data *vc, const unsigned char *table); void (*con_scrolldelta)(struct vc_data *vc, int lines); bool (*con_set_origin)(struct vc_data *vc); void (*con_save_screen)(struct vc_data *vc); u8 (*con_build_attr)(struct vc_data *vc, u8 color, enum vc_intensity intensity, bool blink, bool underline, bool reverse, bool italic); void (*con_invert_region)(struct vc_data *vc, u16 *p, int count); }; **Members** ``owner`` the module to get references of when this console is used ``con_startup`` set up the console and return its name (like VGA, EGA, ...) ``con_init`` initialize the console on **vc**. **init** is true for the very first call on this **vc**. ``con_deinit`` deinitialize the console from **vc**. ``con_clear`` erase **count** characters at [**x**, **y**] on **vc**. **count** >= 1. ``con_putc`` emit one character with attributes **ca** to [**x**, **y**] on **vc**. (optional -- **con_putcs** would be called instead) ``con_putcs`` emit **count** characters with attributes **s** to [**x**, **y**] on **vc**. ``con_cursor`` enable/disable cursor depending on **enable** ``con_scroll`` move lines from **top** to **bottom** in direction **dir** by **lines**. Return true if no generic handling should be done. Invoked by csi_M and printing to the console. ``con_switch`` notifier about the console switch; it is supposed to return true if a redraw is needed. ``con_blank`` blank the console. The preferred VESA blank mode is passed in **blank**. **mode_switch** is set if changing from/to text/graphics. The hook is supposed to return true if a redraw is needed. ``con_unblank`` unblank the console. The hook is supposed to return true if a redraw is needed. **mode_switch** is set if changing from/to text/graphics. ``con_font_set`` set console **vc** font to **font** with height **vpitch**. **flags** can be ``KD_FONT_FLAG_DONT_RECALC``. (optional) ``con_font_get`` fetch the current font on **vc** of height **vpitch** into **font**. (optional) ``con_font_default`` set default font on **vc**. **name** can be ``NULL`` or font name to search for. **font** can be filled back. (optional) ``con_resize`` resize the **vc** console to **width** x **height**. **from_user** is true when this change comes from the user space. ``con_set_palette`` sets the palette of the console **vc** to **table** (optional) ``con_scrolldelta`` the contents of the console should be scrolled by **lines**. Invoked by user. (optional) ``con_set_origin`` set origin (see :c:type:`vc_data`::vc_origin) of the **vc**. If not provided or returns false, the origin is set to **vc->vc_screenbuf**. (optional) ``con_save_screen`` save screen content into **vc->vc_screenbuf**. Called e.g. upon entering graphics. (optional) ``con_build_attr`` build attributes based on **color**, **intensity** and other parameters. The result is used for both normal and erase characters. (optional) ``con_invert_region`` invert a region of length **count** on **vc** starting at **p**. (optional)h](h)}(h**Definition**::h](ju)}(h**Definition**h]h Definition}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjXubh:}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK-hjTubj)}(hXstruct consw { struct module *owner; const char *(*con_startup)(void); void (*con_init)(struct vc_data *vc, bool init); void (*con_deinit)(struct vc_data *vc); void (*con_clear)(struct vc_data *vc, unsigned int y, unsigned int x, unsigned int count); void (*con_putc)(struct vc_data *vc, u16 ca, unsigned int y, unsigned int x); void (*con_putcs)(struct vc_data *vc, const u16 *s, unsigned int count, unsigned int ypos, unsigned int xpos); void (*con_cursor)(struct vc_data *vc, bool enable); bool (*con_scroll)(struct vc_data *vc, unsigned int top, unsigned int bottom, enum con_scroll dir, unsigned int lines); bool (*con_switch)(struct vc_data *vc); bool (*con_blank)(struct vc_data *vc, enum vesa_blank_mode blank, bool mode_switch); bool (*con_unblank)(struct vc_data *vc, bool mode_switch); int (*con_font_set)(struct vc_data *vc, const struct console_font *font, unsigned int vpitch, unsigned int flags); int (*con_font_get)(struct vc_data *vc, struct console_font *font, unsigned int vpitch); int (*con_font_default)(struct vc_data *vc, struct console_font *font, const char *name); int (*con_resize)(struct vc_data *vc, unsigned int width, unsigned int height, bool from_user); void (*con_set_palette)(struct vc_data *vc, const unsigned char *table); void (*con_scrolldelta)(struct vc_data *vc, int lines); bool (*con_set_origin)(struct vc_data *vc); void (*con_save_screen)(struct vc_data *vc); u8 (*con_build_attr)(struct vc_data *vc, u8 color, enum vc_intensity intensity, bool blink, bool underline, bool reverse, bool italic); void (*con_invert_region)(struct vc_data *vc, u16 *p, int count); };h]hXstruct consw { struct module *owner; const char *(*con_startup)(void); void (*con_init)(struct vc_data *vc, bool init); void (*con_deinit)(struct vc_data *vc); void (*con_clear)(struct vc_data *vc, unsigned int y, unsigned int x, unsigned int count); void (*con_putc)(struct vc_data *vc, u16 ca, unsigned int y, unsigned int x); void (*con_putcs)(struct vc_data *vc, const u16 *s, unsigned int count, unsigned int ypos, unsigned int xpos); void (*con_cursor)(struct vc_data *vc, bool enable); bool (*con_scroll)(struct vc_data *vc, unsigned int top, unsigned int bottom, enum con_scroll dir, unsigned int lines); bool (*con_switch)(struct vc_data *vc); bool (*con_blank)(struct vc_data *vc, enum vesa_blank_mode blank, bool mode_switch); bool (*con_unblank)(struct vc_data *vc, bool mode_switch); int (*con_font_set)(struct vc_data *vc, const struct console_font *font, unsigned int vpitch, unsigned int flags); int (*con_font_get)(struct vc_data *vc, struct console_font *font, unsigned int vpitch); int (*con_font_default)(struct vc_data *vc, struct console_font *font, const char *name); int (*con_resize)(struct vc_data *vc, unsigned int width, unsigned int height, bool from_user); void (*con_set_palette)(struct vc_data *vc, const unsigned char *table); void (*con_scrolldelta)(struct vc_data *vc, int lines); bool (*con_set_origin)(struct vc_data *vc); void (*con_save_screen)(struct vc_data *vc); u8 (*con_build_attr)(struct vc_data *vc, u8 color, enum vc_intensity intensity, bool blink, bool underline, bool reverse, bool italic); void (*con_invert_region)(struct vc_data *vc, u16 *p, int count); };}hjusbah}(h]h ]h"]h$]h&]hhuh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK/hjTubh)}(h **Members**h]ju)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKHhjTubj)}(hhh](j)}(hD``owner`` the module to get references of when this console is used h](j)}(h ``owner``h]j)}(hjh]howner}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK,hjubj)}(hhh]h)}(h9the module to get references of when this console is usedh]h9the module to get references of when this console is used}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK,hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK,hjubj)}(hL``con_startup`` set up the console and return its name (like VGA, EGA, ...) h](j)}(h``con_startup``h]j)}(hjh]h con_startup}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK-hjubj)}(hhh]h)}(h;set up the console and return its name (like VGA, EGA, ...)h]h;set up the console and return its name (like VGA, EGA, ...)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK-hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK-hjubj)}(hh``con_init`` initialize the console on **vc**. **init** is true for the very first call on this **vc**. h](j)}(h ``con_init``h]j)}(hjh]hcon_init}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK/hjubj)}(hhh]h)}(hZinitialize the console on **vc**. **init** is true for the very first call on this **vc**.h](hinitialize the console on }(hj0hhhNhNubju)}(h**vc**h]hvc}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj0ubh. }(hj0hhhNhNubju)}(h**init**h]hinit}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jthj0ubh) is true for the very first call on this }(hj0hhhNhNubju)}(h**vc**h]hvc}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj0ubh.}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK.hj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hK/hjubj)}(h5``con_deinit`` deinitialize the console from **vc**. h](j)}(h``con_deinit``h]j)}(hjh]h con_deinit}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK0hjubj)}(hhh]h)}(h%deinitialize the console from **vc**.h](hdeinitialize the console from }(hjhhhNhNubju)}(h**vc**h]hvc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK0hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK0hjubj)}(hV``con_clear`` erase **count** characters at [**x**, **y**] on **vc**. **count** >= 1. h](j)}(h ``con_clear``h]j)}(hjh]h con_clear}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK1hjubj)}(hhh]h)}(hGerase **count** characters at [**x**, **y**] on **vc**. **count** >= 1.h](herase }(hjhhhNhNubju)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh characters at [}(hjhhhNhNubju)}(h**x**h]hx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh, }(hjhhhNhNubju)}(h**y**h]hy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh] on }(hjhhhNhNubju)}(h**vc**h]hvc}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh. }(hjhhhNhNubju)}(h **count**h]hcount}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh >= 1.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK1hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK1hjubj)}(h``con_putc`` emit one character with attributes **ca** to [**x**, **y**] on **vc**. (optional -- **con_putcs** would be called instead) h](j)}(h ``con_putc``h]j)}(hjeh]hcon_putc}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK3hj_ubj)}(hhh]h)}(hzemit one character with attributes **ca** to [**x**, **y**] on **vc**. (optional -- **con_putcs** would be called instead)h](h#emit one character with attributes }(hj~hhhNhNubju)}(h**ca**h]hca}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthj~ubh to [}(hj~hhhNhNubju)}(h**x**h]hx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthj~ubh, }(hj~hhhNhNubju)}(h**y**h]hy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthj~ubh] on }(hj~hhhNhNubju)}(h**vc**h]hvc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthj~ubh. (optional -- }(hj~hhhNhNubju)}(h **con_putcs**h]h con_putcs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthj~ubh would be called instead)}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK2hj{ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhjzhK3hjubj)}(h[``con_putcs`` emit **count** characters with attributes **s** to [**x**, **y**] on **vc**. h](j)}(h ``con_putcs``h]j)}(hjh]h con_putcs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK4hjubj)}(hhh]h)}(hLemit **count** characters with attributes **s** to [**x**, **y**] on **vc**.h](hemit }(hjhhhNhNubju)}(h **count**h]hcount}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh characters with attributes }(hjhhhNhNubju)}(h**s**h]hs}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh to [}(hjhhhNhNubju)}(h**x**h]hx}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh, }(hjhhhNhNubju)}(h**y**h]hy}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh] on }(hjhhhNhNubju)}(h**vc**h]hvc}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK4hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK4hjubj)}(h=``con_cursor`` enable/disable cursor depending on **enable** h](j)}(h``con_cursor``h]j)}(hjh]h con_cursor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK5hjubj)}(hhh]h)}(h-enable/disable cursor depending on **enable**h](h#enable/disable cursor depending on }(hjhhhNhNubju)}(h **enable**h]henable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubeh}(h]h ]h"]h$]h&]uh1hhjhK5hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK5hjubj)}(h``con_scroll`` move lines from **top** to **bottom** in direction **dir** by **lines**. Return true if no generic handling should be done. Invoked by csi_M and printing to the console. h](j)}(h``con_scroll``h]j)}(hjh]h con_scroll}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK8hjubj)}(hhh]h)}(hmove lines from **top** to **bottom** in direction **dir** by **lines**. Return true if no generic handling should be done. Invoked by csi_M and printing to the console.h](hmove lines from }(hjhhhNhNubju)}(h**top**h]htop}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh to }(hjhhhNhNubju)}(h **bottom**h]hbottom}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh in direction }(hjhhhNhNubju)}(h**dir**h]hdir}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh by }(hjhhhNhNubju)}(h **lines**h]hlines}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubhb. Return true if no generic handling should be done. Invoked by csi_M and printing to the console.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK8hjubj)}(hg``con_switch`` notifier about the console switch; it is supposed to return true if a redraw is needed. h](j)}(h``con_switch``h]j)}(hjUh]h con_switch}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK:hjOubj)}(hhh]h)}(hWnotifier about the console switch; it is supposed to return true if a redraw is needed.h]hWnotifier about the console switch; it is supposed to return true if a redraw is needed.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK9hjkubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjjhK:hjubj)}(h``con_blank`` blank the console. The preferred VESA blank mode is passed in **blank**. **mode_switch** is set if changing from/to text/graphics. The hook is supposed to return true if a redraw is needed. h](j)}(h ``con_blank``h]j)}(hjh]h con_blank}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK=hjubj)}(hhh]h)}(hblank the console. The preferred VESA blank mode is passed in **blank**. **mode_switch** is set if changing from/to text/graphics. The hook is supposed to return true if a redraw is needed.h](h>blank the console. The preferred VESA blank mode is passed in }(hjhhhNhNubju)}(h **blank**h]hblank}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh. }(hjhhhNhNubju)}(h**mode_switch**h]h mode_switch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubhe is set if changing from/to text/graphics. The hook is supposed to return true if a redraw is needed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK=hjubj)}(h``con_unblank`` unblank the console. The hook is supposed to return true if a redraw is needed. **mode_switch** is set if changing from/to text/graphics. h](j)}(h``con_unblank``h]j)}(hjh]h con_unblank}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK@hjubj)}(hhh]h)}(hunblank the console. The hook is supposed to return true if a redraw is needed. **mode_switch** is set if changing from/to text/graphics.h](hPunblank the console. The hook is supposed to return true if a redraw is needed. }(hjhhhNhNubju)}(h**mode_switch**h]h mode_switch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh* is set if changing from/to text/graphics.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhK>hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK@hjubj)}(h``con_font_set`` set console **vc** font to **font** with height **vpitch**. **flags** can be ``KD_FONT_FLAG_DONT_RECALC``. (optional) h](j)}(h``con_font_set``h]j)}(hj9h]h con_font_set}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKBhj3ubj)}(hhh]h)}(huset console **vc** font to **font** with height **vpitch**. **flags** can be ``KD_FONT_FLAG_DONT_RECALC``. (optional)h](h set console }(hjRhhhNhNubju)}(h**vc**h]hvc}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjRubh font to }(hjRhhhNhNubju)}(h**font**h]hfont}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjRubh with height }(hjRhhhNhNubju)}(h **vpitch**h]hvpitch}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjRubh. }(hjRhhhNhNubju)}(h **flags**h]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjRubh can be }(hjRhhhNhNubj)}(h``KD_FONT_FLAG_DONT_RECALC``h]hKD_FONT_FLAG_DONT_RECALC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh . (optional)}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKAhjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhKBhjubj)}(ha``con_font_get`` fetch the current font on **vc** of height **vpitch** into **font**. (optional) h](j)}(h``con_font_get``h]j)}(hjh]h con_font_get}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKDhjubj)}(hhh]h)}(hOfetch the current font on **vc** of height **vpitch** into **font**. (optional)h](hfetch the current font on }(hjhhhNhNubju)}(h**vc**h]hvc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh of height }(hjhhhNhNubju)}(h **vpitch**h]hvpitch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh into }(hjhhhNhNubju)}(h**font**h]hfont}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh . (optional)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKChjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKDhjubj)}(h``con_font_default`` set default font on **vc**. **name** can be ``NULL`` or font name to search for. **font** can be filled back. (optional) h](j)}(h``con_font_default``h]j)}(hj=h]hcon_font_default}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKFhj7ubj)}(hhh]h)}(hxset default font on **vc**. **name** can be ``NULL`` or font name to search for. **font** can be filled back. (optional)h](hset default font on }(hjVhhhNhNubju)}(h**vc**h]hvc}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjVubh. }(hjVhhhNhNubju)}(h**name**h]hname}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jthjVubh can be }(hjVhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVubh or font name to search for. }(hjVhhhNhNubju)}(h**font**h]hfont}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjVubh can be filled back. (optional)}(hjVhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKEhjSubah}(h]h ]h"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]uh1jhjRhKFhjubj)}(h``con_resize`` resize the **vc** console to **width** x **height**. **from_user** is true when this change comes from the user space. h](j)}(h``con_resize``h]j)}(hjh]h con_resize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKHhjubj)}(hhh]h)}(hvresize the **vc** console to **width** x **height**. **from_user** is true when this change comes from the user space.h](h resize the }(hjhhhNhNubju)}(h**vc**h]hvc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh console to }(hjhhhNhNubju)}(h **width**h]hwidth}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh x }(hjhhhNhNubju)}(h **height**h]hheight}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh. }(hjhhhNhNubju)}(h **from_user**h]h from_user}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh4 is true when this change comes from the user space.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKGhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKHhjubj)}(hS``con_set_palette`` sets the palette of the console **vc** to **table** (optional) h](j)}(h``con_set_palette``h]j)}(hjAh]hcon_set_palette}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKIhj;ubj)}(hhh]h)}(h>sets the palette of the console **vc** to **table** (optional)h](h sets the palette of the console }(hjZhhhNhNubju)}(h**vc**h]hvc}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjZubh to }(hjZhhhNhNubju)}(h **table**h]htable}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jthjZubh (optional)}(hjZhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjVhKIhjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhKIhjubj)}(hm``con_scrolldelta`` the contents of the console should be scrolled by **lines**. Invoked by user. (optional) h](j)}(h``con_scrolldelta``h]j)}(hjh]hcon_scrolldelta}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKKhjubj)}(hhh]h)}(hXthe contents of the console should be scrolled by **lines**. Invoked by user. (optional)h](h2the contents of the console should be scrolled by }(hjhhhNhNubju)}(h **lines**h]hlines}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjubh. Invoked by user. (optional)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKJhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKKhjubj)}(h``con_set_origin`` set origin (see :c:type:`vc_data`::vc_origin) of the **vc**. If not provided or returns false, the origin is set to **vc->vc_screenbuf**. (optional) h](j)}(h``con_set_origin``h]j)}(hjh]hcon_set_origin}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKNhjubj)}(hhh]h)}(hset origin (see :c:type:`vc_data`::vc_origin) of the **vc**. If not provided or returns false, the origin is set to **vc->vc_screenbuf**. (optional)h](hset origin (see }(hj hhhNhNubh)}(h:c:type:`vc_data`h]j)}(hj h]hvc_data}(hj hhhNhNubah}(h]h ](xrefj_c-typeeh"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]refdocdriver-api/tty/console refdomainj_reftypetype refexplicitrefwarn c:parent_keysphinx.domains.c LookupKey)}data]sb reftargetvc_datauh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKLhj ubh::vc_origin) of the }(hj hhhNhNubju)}(h**vc**h]hvc}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj ubh9. If not provided or returns false, the origin is set to }(hj hhhNhNubju)}(h**vc->vc_screenbuf**h]hvc->vc_screenbuf}(hjL hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj ubh . (optional)}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj5 hKLhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKNhjubj)}(hr``con_save_screen`` save screen content into **vc->vc_screenbuf**. Called e.g. upon entering graphics. (optional) h](j)}(h``con_save_screen``h]j)}(hjv h]hcon_save_screen}(hjx hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjt ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKPhjp ubj)}(hhh]h)}(h]save screen content into **vc->vc_screenbuf**. Called e.g. upon entering graphics. (optional)h](hsave screen content into }(hj hhhNhNubju)}(h**vc->vc_screenbuf**h]hvc->vc_screenbuf}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj ubh0. Called e.g. upon entering graphics. (optional)}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKOhj ubah}(h]h ]h"]h$]h&]uh1jhjp ubeh}(h]h ]h"]h$]h&]uh1jhj hKPhjubj)}(h``con_build_attr`` build attributes based on **color**, **intensity** and other parameters. The result is used for both normal and erase characters. (optional) h](j)}(h``con_build_attr``h]j)}(hj h]hcon_build_attr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKShj ubj)}(hhh]h)}(hbuild attributes based on **color**, **intensity** and other parameters. The result is used for both normal and erase characters. (optional)h](hbuild attributes based on }(hj hhhNhNubju)}(h **color**h]hcolor}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj ubh, }(hj hhhNhNubju)}(h **intensity**h]h intensity}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj ubhZ and other parameters. The result is used for both normal and erase characters. (optional)}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKQhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKShjubj)}(ha``con_invert_region`` invert a region of length **count** on **vc** starting at **p**. (optional)h](j)}(h``con_invert_region``h]j)}(hj !h]hcon_invert_region}(hj"!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj!ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:24: ./include/linux/console.hhKThj!ubj)}(hhh]h)}(hKinvert a region of length **count** on **vc** starting at **p**. (optional)h](hinvert a region of length }(hj9!hhhNhNubju)}(h **count**h]hcount}(hjA!hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj9!ubh on }(hj9!hhhNhNubju)}(h**vc**h]hvc}(hjS!hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj9!ubh starting at }(hj9!hhhNhNubju)}(h**p**h]hp}(hje!hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj9!ubh . (optional)}(hj9!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj5!hKThj6!ubah}(h]h ]h"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]uh1jhj5!hKThjubeh}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhjhhhNhNubeh}(h]jOah ]h"] struct conswah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hConsole functionsh]hConsole functions}(hj!hhhNhNubah}(h]h ]h"]h$]h&]jjkuh1hhj!hhhhhKubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$console_srcu_read_flags (C function)c.console_srcu_read_flagshNtauh1jhj!hhhNhNubj)}(hhh](j)}(h9short console_srcu_read_flags (const struct console *con)h]j)}(h8short console_srcu_read_flags(const struct console *con)h](hdesc_sig_keyword_type)}(hshorth]hshort}(hj!hhhNhNubah}(h]h ]ktah"]h$]h&]uh1j!hj!hhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMubj)}(h h]h }(hj!hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj!hhhj!hMubj)}(hconsole_srcu_read_flagsh]j)}(hconsole_srcu_read_flagsh]hconsole_srcu_read_flags}(hj!hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj!ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj!hhhj!hMubhdesc_parameterlist)}(h(const struct console *con)h]hdesc_parameter)}(hconst struct console *conh](j)}(hconsth]hconst}(hj "hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj"hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj"ubj)}(hjh]hstruct}(hj'"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubj)}(h h]h }(hj4"hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj"ubh)}(hhh]j)}(hconsoleh]hconsole}(hjE"hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjB"ubah}(h]h ]h"]h$]h&] refdomainj_reftype identifier reftargetjG"modnameN classnameNj+ j. )}j1 ]j, ASTIdentifier)}j["j!sbc.console_srcu_read_flagsasbuh1hhj"ubj)}(h h]h }(hjh"hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj"ubhdesc_sig_punctuation)}(h*h]h*}(hjx"hhhNhNubah}(h]h ]pah"]h$]h&]uh1jv"hj"ubj)}(hconh]hcon}(hj"hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj"ubah}(h]h ]h"]h$]h&]hhuh1j!hj!hhhj!hMubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj!hhhj!hMubah}(h]j!ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj!hMhj!hhubjC)}(hhh]h)}(h6Locklessly read flags of a possibly registered consoleh]h6Locklessly read flags of a possibly registered console}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj"hhubah}(h]h ]h"]h$]h&]uh1jBhj!hhhj!hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej"jfj"jgjhjiuh1jhhhj!hNhNubjk)}(hX{**Parameters** ``const struct console *con`` struct console pointer of console to read flags from **Description** Locklessly reading **con->flags** provides a consistent read value because there is at most one CPU modifying **con->flags** and that CPU is using only read-modify-write operations to do so. Requires console_srcu_read_lock to be held, which implies that **con** might be a registered console. The purpose of holding console_srcu_read_lock is to guarantee that the console state is valid (CON_SUSPENDED/CON_ENABLED) and that no exit/cleanup routines will run if the console is currently undergoing unregistration. If the caller is holding the console_list_lock or it is _certain_ that **con** is not and will not become registered, the caller may read **con->flags** directly instead. **Context** Any context. **Return** The current value of the **con->flags** field.h](h)}(h**Parameters**h]ju)}(hj"h]h Parameters}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj"ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj"ubj)}(hhh]j)}(hS``const struct console *con`` struct console pointer of console to read flags from h](j)}(h``const struct console *con``h]j)}(hj"h]hconst struct console *con}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj"ubj)}(hhh]h)}(h4struct console pointer of console to read flags fromh]h4struct console pointer of console to read flags from}(hj #hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hMhj#ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj#hMhj"ubah}(h]h ]h"]h$]h&]uh1jhj"ubh)}(h**Description**h]ju)}(hj-#h]h Description}(hj/#hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj+#ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj"ubh)}(hLocklessly reading **con->flags** provides a consistent read value because there is at most one CPU modifying **con->flags** and that CPU is using only read-modify-write operations to do so.h](hLocklessly reading }(hjC#hhhNhNubju)}(h**con->flags**h]h con->flags}(hjK#hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjC#ubhM provides a consistent read value because there is at most one CPU modifying }(hjC#hhhNhNubju)}(h**con->flags**h]h con->flags}(hj]#hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjC#ubhB and that CPU is using only read-modify-write operations to do so.}(hjC#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj"ubh)}(hXARequires console_srcu_read_lock to be held, which implies that **con** might be a registered console. The purpose of holding console_srcu_read_lock is to guarantee that the console state is valid (CON_SUSPENDED/CON_ENABLED) and that no exit/cleanup routines will run if the console is currently undergoing unregistration.h](h?Requires console_srcu_read_lock to be held, which implies that }(hjv#hhhNhNubju)}(h**con**h]hcon}(hj~#hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjv#ubh might be a registered console. The purpose of holding console_srcu_read_lock is to guarantee that the console state is valid (CON_SUSPENDED/CON_ENABLED) and that no exit/cleanup routines will run if the console is currently undergoing unregistration.}(hjv#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj"ubh)}(hIf the caller is holding the console_list_lock or it is _certain_ that **con** is not and will not become registered, the caller may read **con->flags** directly instead.h](hGIf the caller is holding the console_list_lock or it is _certain_ that }(hj#hhhNhNubju)}(h**con**h]hcon}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj#ubh< is not and will not become registered, the caller may read }(hj#hhhNhNubju)}(h**con->flags**h]h con->flags}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj#ubh directly instead.}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj"ubh)}(h **Context**h]ju)}(hj#h]hContext}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj#ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhM hj"ubh)}(h Any context.h]h Any context.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhM hj"ubh)}(h **Return**h]ju)}(hj#h]hReturn}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj#ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhM hj"ubh)}(h.The current value of the **con->flags** field.h](hThe current value of the }(hj $hhhNhNubju)}(h**con->flags**h]h con->flags}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj $ubh field.}(hj $hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhM hj"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j%console_srcu_write_flags (C function)c.console_srcu_write_flagshNtauh1jhj!hhhNhNubj)}(hhh](j)}(h@void console_srcu_write_flags (struct console *con, short flags)h]j)}(h?void console_srcu_write_flags(struct console *con, short flags)h](j!)}(hvoidh]hvoid}(hjJ$hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hjF$hhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMubj)}(h h]h }(hjY$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjF$hhhjX$hMubj)}(hconsole_srcu_write_flagsh]j)}(hconsole_srcu_write_flagsh]hconsole_srcu_write_flags}(hjk$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjg$ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjF$hhhjX$hMubj")}(h"(struct console *con, short flags)h](j")}(hstruct console *conh](j)}(hjh]hstruct}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj$ubh)}(hhh]j)}(hconsoleh]hconsole}(hj$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj$modnameN classnameNj+ j. )}j1 ]jc")}j["jm$sbc.console_srcu_write_flagsasbuh1hhj$ubj)}(h h]h }(hj$hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj$ubjw")}(hjz"h]h*}(hj$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hj$ubj)}(hconh]hcon}(hj$hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj$ubj")}(h short flagsh](j!)}(hshorth]hshort}(hj$hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj$ubj)}(h h]h }(hj%hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj$ubj)}(hflagsh]hflags}(hj%hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj$ubeh}(h]h ]h"]h$]h&]hhuh1j!hjF$hhhjX$hMubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjB$hhhjX$hMubah}(h]j=$ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjX$hMhj?$hhubjC)}(hhh]h)}(h$Write flags for a registered consoleh]h$Write flags for a registered console}(hj?%hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj<%hhubah}(h]h ]h"]h$]h&]uh1jBhj?$hhhjX$hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejW%jfjW%jgjhjiuh1jhhhj!hNhNubjk)}(hX **Parameters** ``struct console *con`` struct console pointer of console to write flags to ``short flags`` new flags value to write **Description** Only use this function to write flags for registered consoles. It requires holding the console_list_lock. **Context** Any context.h](h)}(h**Parameters**h]ju)}(hja%h]h Parameters}(hjc%hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj_%ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj[%ubj)}(hhh](j)}(hL``struct console *con`` struct console pointer of console to write flags to h](j)}(h``struct console *con``h]j)}(hj%h]hstruct console *con}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~%ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhjz%ubj)}(hhh]h)}(h3struct console pointer of console to write flags toh]h3struct console pointer of console to write flags to}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hMhj%ubah}(h]h ]h"]h$]h&]uh1jhjz%ubeh}(h]h ]h"]h$]h&]uh1jhj%hMhjw%ubj)}(h)``short flags`` new flags value to write h](j)}(h``short flags``h]j)}(hj%h]h short flags}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj%ubj)}(hhh]h)}(hnew flags value to writeh]hnew flags value to write}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hMhj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%hMhjw%ubeh}(h]h ]h"]h$]h&]uh1jhj[%ubh)}(h**Description**h]ju)}(hj%h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj%ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj[%ubh)}(hiOnly use this function to write flags for registered consoles. It requires holding the console_list_lock.h]hiOnly use this function to write flags for registered consoles. It requires holding the console_list_lock.}(hj &hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMhj[%ubh)}(h **Context**h]ju)}(hj&h]hContext}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj&ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhM hj[%ubh)}(h Any context.h]h Any context.}(hj1&hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhM!hj[%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jfor_each_console_srcu (C macro)c.for_each_console_srcuhNtauh1jhj!hhhNhNubj)}(hhh](j)}(hfor_each_console_srcuh]j)}(hfor_each_console_srcuh]j)}(hfor_each_console_srcuh]j)}(hjZ&h]hfor_each_console_srcu}(hjd&hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj`&ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj\&hhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMHubah}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjX&hhhjw&hMHubah}(h]jS&ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjw&hMHhjU&hhubjC)}(hhh]h}(h]h ]h"]h$]h&]uh1jBhjU&hhhjw&hMHubeh}(h]h ](j_macroeh"]h$]h&]jdj_jej&jfj&jgjhjiuh1jhhhj!hNhNubh)}(h``for_each_console_srcu (con)``h]j)}(hj&h]hfor_each_console_srcu (con)}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMJhj!hhubh block_quote)}(h"Iterator over registered consoles h]h)}(h!Iterator over registered consolesh]h!Iterator over registered consoles}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMHhj&ubah}(h]h ]h"]h$]h&]uh1j&hj&hMHhj!hhubjk)}(hX***Parameters** ``con`` struct console pointer used as loop cursor **Description** Although SRCU guarantees the console list will be consistent, the struct console fields may be updated by other CPUs while iterating. Requires console_srcu_read_lock to be held. Can be invoked from any context.h](h)}(h**Parameters**h]ju)}(hj&h]h Parameters}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj&ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMLhj&ubj)}(hhh]j)}(h3``con`` struct console pointer used as loop cursor h](j)}(h``con``h]j)}(hj&h]hcon}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMIhj&ubj)}(hhh]h)}(h*struct console pointer used as loop cursorh]h*struct console pointer used as loop cursor}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMIhj'ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj'hMIhj&ubah}(h]h ]h"]h$]h&]uh1jhj&ubh)}(h**Description**h]ju)}(hj''h]h Description}(hj)'hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj%'ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMKhj&ubh)}(hAlthough SRCU guarantees the console list will be consistent, the struct console fields may be updated by other CPUs while iterating.h]hAlthough SRCU guarantees the console list will be consistent, the struct console fields may be updated by other CPUs while iterating.}(hj='hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMJhj&ubh)}(hLRequires console_srcu_read_lock to be held. Can be invoked from any context.h]hLRequires console_srcu_read_lock to be held. Can be invoked from any context.}(hjL'hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMMhj&ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jfor_each_console (C macro)c.for_each_consolehNtauh1jhj!hhhNhNubj)}(hhh](j)}(hfor_each_consoleh]j)}(hfor_each_consoleh]j)}(hfor_each_consoleh]j)}(hju'h]hfor_each_console}(hj'hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj{'ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjw'hhh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMVubah}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjs'hhhj'hMVubah}(h]jn'ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj'hMVhjp'hhubjC)}(hhh]h}(h]h ]h"]h$]h&]uh1jBhjp'hhhj'hMVubeh}(h]h ](j_macroeh"]h$]h&]jdj_jej'jfj'jgjhjiuh1jhhhj!hNhNubh)}(h``for_each_console (con)``h]j)}(hj'h]hfor_each_console (con)}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMXhj!hhubj&)}(h"Iterator over registered consoles h]h)}(h!Iterator over registered consolesh]h!Iterator over registered consoles}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMVhj'ubah}(h]h ]h"]h$]h&]uh1j&hj'hMVhj!hhubjk)}(h**Parameters** ``con`` struct console pointer used as loop cursor **Description** The console list and the :c:type:`console.flags ` are immutable while iterating. Requires console_list_lock to be held.h](h)}(h**Parameters**h]ju)}(hj'h]h Parameters}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj'ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMZhj'ubj)}(hhh]j)}(h3``con`` struct console pointer used as loop cursor h](j)}(h``con``h]j)}(hj(h]hcon}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMWhj'ubj)}(hhh]h)}(h*struct console pointer used as loop cursorh]h*struct console pointer used as loop cursor}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMWhj(ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj(hMWhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubh)}(h**Description**h]ju)}(hj@(h]h Description}(hjB(hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj>(ubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMYhj'ubh)}(hYThe console list and the :c:type:`console.flags ` are immutable while iterating.h](hThe console list and the }(hjV(hhhNhNubh)}(h!:c:type:`console.flags `h]j)}(hj`(h]h console.flags}(hjb(hhhNhNubah}(h]h ](j j_c-typeeh"]h$]h&]uh1jhj^(ubah}(h]h ]h"]h$]h&]refdocj% refdomainj_reftypetype refexplicitrefwarnj+ j/ j3 consoleuh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMXhjV(ubh are immutable while iterating.}(hjV(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj}(hMXhj'ubh)}(h&Requires console_list_lock to be held.h]h&Requires console_list_lock to be held.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hh^/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:30: ./include/linux/console.hhMZhj'ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jclear_selection (C function)c.clear_selectionhNtauh1jhj!hhhNhNubj)}(hhh](j)}(hvoid clear_selection (void)h]j)}(hvoid clear_selection(void)h](j!)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj(hhha/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:34: ./drivers/tty/vt/selection.chKLubj)}(h h]h }(hj(hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj(hhhj(hKLubj)}(hclear_selectionh]j)}(hclear_selectionh]hclear_selection}(hj(hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj(ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj(hhhj(hKLubj")}(h(void)h]j")}(hvoidh]j!)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj(ubah}(h]h ]h"]h$]h&]noemphhhuh1j"hj(ubah}(h]h ]h"]h$]h&]hhuh1j!hj(hhhj(hKLubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj(hhhj(hKLubah}(h]j(ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj(hKLhj(hhubjC)}(hhh]h)}(hremove current selectionh]hremove current selection}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:34: ./drivers/tty/vt/selection.chKLhj)hhubah}(h]h ]h"]h$]h&]uh1jBhj(hhhj(hKLubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej6)jfj6)jgjhjiuh1jhhhj!hNhNubjk)}(h**Parameters** ``void`` no arguments **Description** Remove the current selection highlight, if any from the console holding the selection. Locking: The caller must hold the console lock.h](h)}(h**Parameters**h]ju)}(hj@)h]h Parameters}(hjB)hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj>)ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:34: ./drivers/tty/vt/selection.chKPhj:)ubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]j)}(hj_)h]hvoid}(hja)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj])ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:34: ./drivers/tty/vt/selection.chKhjY)ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjx)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjt)hKhju)ubah}(h]h ]h"]h$]h&]uh1jhjY)ubeh}(h]h ]h"]h$]h&]uh1jhjt)hKhjV)ubah}(h]h ]h"]h$]h&]uh1jhj:)ubh)}(h**Description**h]ju)}(hj)h]h Description}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj)ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:34: ./drivers/tty/vt/selection.chKhj:)ubh)}(hVRemove the current selection highlight, if any from the console holding the selection.h]hVRemove the current selection highlight, if any from the console holding the selection.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:34: ./drivers/tty/vt/selection.chKMhj:)ubh)}(h/Locking: The caller must hold the console lock.h]h/Locking: The caller must hold the console lock.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:34: ./drivers/tty/vt/selection.chKPhj:)ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jvc_font_pitch (C function)c.vc_font_pitchhNtauh1jhj!hhhNhNubj)}(hhh](j)}(h7unsigned int vc_font_pitch (const struct vc_font *font)h]j)}(h6unsigned int vc_font_pitch(const struct vc_font *font)h](j!)}(hunsignedh]hunsigned}(hj)hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj)hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKubj)}(h h]h }(hj)hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj)hhhj)hKubj!)}(hinth]hint}(hj *hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj)hhhj)hKubj)}(h h]h }(hj*hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj)hhhj)hKubj)}(h vc_font_pitchh]j)}(h vc_font_pitchh]h vc_font_pitch}(hj+*hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj'*ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj)hhhj)hKubj")}(h(const struct vc_font *font)h]j")}(hconst struct vc_font *fonth](j)}(hj "h]hconst}(hjG*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjC*ubj)}(h h]h }(hjT*hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjC*ubj)}(hjh]hstruct}(hjb*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjC*ubj)}(h h]h }(hjo*hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjC*ubh)}(hhh]j)}(hvc_fonth]hvc_font}(hj*hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj}*ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj*modnameN classnameNj+ j. )}j1 ]jc")}j["j-*sbc.vc_font_pitchasbuh1hhjC*ubj)}(h h]h }(hj*hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjC*ubjw")}(hjz"h]h*}(hj*hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hjC*ubj)}(hfonth]hfont}(hj*hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjC*ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj?*ubah}(h]h ]h"]h$]h&]hhuh1j!hj)hhhj)hKubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj)hhhj)hKubah}(h]j)ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj)hKhj)hhubjC)}(hhh]h)}(h=Calculates the number of bytes between two adjacent scanlinesh]h=Calculates the number of bytes between two adjacent scanlines}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj*hhubah}(h]h ]h"]h$]h&]uh1jBhj)hhhj)hKubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej*jfj*jgjhjiuh1jhhhj!hNhNubjk)}(h**Parameters** ``const struct vc_font *font`` The VC font **Return** The number of bytes between two adjacent scanlines in the font datah](h)}(h**Parameters**h]ju)}(hj+h]h Parameters}(hj +hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj+ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj+ubj)}(hhh]j)}(h+``const struct vc_font *font`` The VC font h](j)}(h``const struct vc_font *font``h]j)}(hj&+h]hconst struct vc_font *font}(hj(+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$+ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj +ubj)}(hhh]h)}(h The VC fonth]h The VC font}(hj?+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;+hKhj<+ubah}(h]h ]h"]h$]h&]uh1jhj +ubeh}(h]h ]h"]h$]h&]uh1jhj;+hKhj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubh)}(h **Return**h]ju)}(hja+h]hReturn}(hjc+hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj_+ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj+ubh)}(hCThe number of bytes between two adjacent scanlines in the font datah]hCThe number of bytes between two adjacent scanlines in the font data}(hjw+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jvc_font_size (C function)c.vc_font_sizehNtauh1jhj!hhhNhNubj)}(hhh](j)}(h6unsigned int vc_font_size (const struct vc_font *font)h]j)}(h5unsigned int vc_font_size(const struct vc_font *font)h](j!)}(hunsignedh]hunsigned}(hj+hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj+hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKubj)}(h h]h }(hj+hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj+hhhj+hKubj!)}(hinth]hint}(hj+hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj+hhhj+hKubj)}(h h]h }(hj+hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj+hhhj+hKubj)}(h vc_font_sizeh]j)}(h vc_font_sizeh]h vc_font_size}(hj+hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj+ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj+hhhj+hKubj")}(h(const struct vc_font *font)h]j")}(hconst struct vc_font *fonth](j)}(hj "h]hconst}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj ,hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj+ubj)}(hjh]hstruct}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubj)}(h h]h }(hj',hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj+ubh)}(hhh]j)}(hvc_fonth]hvc_font}(hj8,hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj5,ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj:,modnameN classnameNj+ j. )}j1 ]jc")}j["j+sbc.vc_font_sizeasbuh1hhj+ubj)}(h h]h }(hjX,hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj+ubjw")}(hjz"h]h*}(hjf,hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hj+ubj)}(hfonth]hfont}(hjs,hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj+ubah}(h]h ]h"]h$]h&]hhuh1j!hj+hhhj+hKubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj+hhhj+hKubah}(h]j+ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj+hKhj+hhubjC)}(hhh]h)}(h-Calculates the size of the font data in bytesh]h-Calculates the size of the font data in bytes}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj,hhubah}(h]h ]h"]h$]h&]uh1jBhj+hhhj+hKubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej,jfj,jgjhjiuh1jhhhj!hNhNubjk)}(hX**Parameters** ``const struct vc_font *font`` The VC font **Description** vc_font_size() calculates the number of bytes of font data in the font specified by **font**. The function calculates the size from the font parameters. **Return** The size of the font data in bytes.h](h)}(h**Parameters**h]ju)}(hj,h]h Parameters}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj,ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj,ubj)}(hhh]j)}(h+``const struct vc_font *font`` The VC font h](j)}(h``const struct vc_font *font``h]j)}(hj,h]hconst struct vc_font *font}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj,ubj)}(hhh]h)}(h The VC fonth]h The VC font}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hKhj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhj,hKhj,ubah}(h]h ]h"]h$]h&]uh1jhj,ubh)}(h**Description**h]ju)}(hj-h]h Description}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj-ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj,ubh)}(hvc_font_size() calculates the number of bytes of font data in the font specified by **font**. The function calculates the size from the font parameters.h](hTvc_font_size() calculates the number of bytes of font data in the font specified by }(hj/-hhhNhNubju)}(h**font**h]hfont}(hj7-hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj/-ubh<. The function calculates the size from the font parameters.}(hj/-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj,ubh)}(h **Return**h]ju)}(hjR-h]hReturn}(hjT-hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjP-ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj,ubh)}(h#The size of the font data in bytes.h]h#The size of the font data in bytes.}(hjh-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!vc_cursor_valid_size (C function)c.vc_cursor_valid_sizehNtauh1jhj!hhhNhNubj)}(hhh](j)}(hCalculates the cursor's first scanline within a character cellh]h@Calculates the cursor’s first scanline within a character cell}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM:hj~0hhubah}(h]h ]h"]h$]h&]uh1jBhjj/hhhj/hM:ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej0jfj0jgjhjiuh1jhhhj!hNhNubjk)}(hX**Parameters** ``unsigned int cell_height`` The overall height of the character cell ``unsigned int cursor_size`` The size constant of cursor pattern **Description** The parameter **cell_height** is the height of the character cell as displayed by the console. The argument given in **cursor_size** is one of the CUR_ constants. See vc_cursor_valid_size() for how to get a valid cursor-size constant. **Return** The index of the cursor's first scanline within the character cellh](h)}(h**Parameters**h]ju)}(hj0h]h Parameters}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj0ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM>hj0ubj)}(hhh](j)}(hF``unsigned int cell_height`` The overall height of the character cell h](j)}(h``unsigned int cell_height``h]j)}(hj0h]hunsigned int cell_height}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM;hj0ubj)}(hhh]h)}(h(The overall height of the character cellh]h(The overall height of the character cell}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hM;hj0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0hM;hj0ubj)}(hA``unsigned int cursor_size`` The size constant of cursor pattern h](j)}(h``unsigned int cursor_size``h]j)}(hj0h]hunsigned int cursor_size}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM<hj0ubj)}(hhh]h)}(h#The size constant of cursor patternh]h#The size constant of cursor pattern}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hM<hj1ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj1hM<hj0ubeh}(h]h ]h"]h$]h&]uh1jhj0ubh)}(h**Description**h]ju)}(hj61h]h Description}(hj81hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj41ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM>hj0ubh)}(hThe parameter **cell_height** is the height of the character cell as displayed by the console. The argument given in **cursor_size** is one of the CUR_ constants. See vc_cursor_valid_size() for how to get a valid cursor-size constant.h](hThe parameter }(hjL1hhhNhNubju)}(h**cell_height**h]h cell_height}(hjT1hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjL1ubhX is the height of the character cell as displayed by the console. The argument given in }(hjL1hhhNhNubju)}(h**cursor_size**h]h cursor_size}(hjf1hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjL1ubh is one of the }(hjL1hhhNhNubj.)}(hCUR_h]hCUR_}hjx1sbah}(h]id10ah ]h"]h$]h&]refidid9uh1j.hjL1hhhNhNubhS constants. See vc_cursor_valid_size() for how to get a valid cursor-size constant.}(hjL1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM=hj0ubh)}(h **Return**h]ju)}(hj1h]hReturn}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj1ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMBhj0ubh)}(hBThe index of the cursor's first scanline within the character cellh]hDThe index of the cursor’s first scanline within the character cell}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMChj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jvc_cursor_end (C function)c.vc_cursor_endhNtauh1jhj!hhhNhNubj)}(hhh](j)}(hOunsigned int vc_cursor_end (unsigned int cell_height, unsigned int cursor_size)h]j)}(hNunsigned int vc_cursor_end(unsigned int cell_height, unsigned int cursor_size)h](j!)}(hunsignedh]hunsigned}(hj1hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj1hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM^ubj)}(h h]h }(hj1hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj1hhhj1hM^ubj!)}(hinth]hint}(hj1hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj1hhhj1hM^ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj1hhhj1hM^ubj)}(h vc_cursor_endh]j)}(h vc_cursor_endh]h vc_cursor_end}(hj2hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj2ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj1hhhj1hM^ubj")}(h4(unsigned int cell_height, unsigned int cursor_size)h](j")}(hunsigned int cell_heighth](j!)}(hunsignedh]hunsigned}(hj42hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj02ubj)}(h h]h }(hjB2hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj02ubj!)}(hinth]hint}(hjP2hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj02ubj)}(h h]h }(hj^2hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj02ubj)}(h cell_heighth]h cell_height}(hjl2hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj02ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj,2ubj")}(hunsigned int cursor_sizeh](j!)}(hunsignedh]hunsigned}(hj2hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj2ubj!)}(hinth]hint}(hj2hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj2ubj)}(h h]h }(hj2hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj2ubj)}(h cursor_sizeh]h cursor_size}(hj2hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj,2ubeh}(h]h ]h"]h$]h&]hhuh1j!hj1hhhj1hM^ubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj1hhhj1hM^ubah}(h]j1ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj1hM^hj1hhubjC)}(hhh]h)}(hFCalculates the first scanline after the cursor within a character cellh]hFCalculates the first scanline after the cursor within a character cell}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM^hj2hhubah}(h]h ]h"]h$]h&]uh1jBhj1hhhj1hM^ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej2jfj2jgjhjiuh1jhhhj!hNhNubjk)}(hX**Parameters** ``unsigned int cell_height`` The overall height of the character cell ``unsigned int cursor_size`` The size constant of cursor pattern **Description** The parameter **cell_height** is the height of the character cell as displayed by the console. The argument given in **cursor_size** is one of the CUR_ constants. See vc_cursor_valid_size() for how to get a valid cursor-size constant. **Return** The index of the first scanline after the cursor within the character cellh](h)}(h**Parameters**h]ju)}(hj 3h]h Parameters}(hj 3hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj3ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMbhj3ubj)}(hhh](j)}(hF``unsigned int cell_height`` The overall height of the character cell h](j)}(h``unsigned int cell_height``h]j)}(hj(3h]hunsigned int cell_height}(hj*3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&3ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM_hj"3ubj)}(hhh]h)}(h(The overall height of the character cellh]h(The overall height of the character cell}(hjA3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=3hM_hj>3ubah}(h]h ]h"]h$]h&]uh1jhj"3ubeh}(h]h ]h"]h$]h&]uh1jhj=3hM_hj3ubj)}(hA``unsigned int cursor_size`` The size constant of cursor pattern h](j)}(h``unsigned int cursor_size``h]j)}(hja3h]hunsigned int cursor_size}(hjc3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_3ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM`hj[3ubj)}(hhh]h)}(h#The size constant of cursor patternh]h#The size constant of cursor pattern}(hjz3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjv3hM`hjw3ubah}(h]h ]h"]h$]h&]uh1jhj[3ubeh}(h]h ]h"]h$]h&]uh1jhjv3hM`hj3ubeh}(h]h ]h"]h$]h&]uh1jhj3ubh)}(h**Description**h]ju)}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj3ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMbhj3ubh)}(hThe parameter **cell_height** is the height of the character cell as displayed by the console. The argument given in **cursor_size** is one of the CUR_ constants. See vc_cursor_valid_size() for how to get a valid cursor-size constant.h](hThe parameter }(hj3hhhNhNubju)}(h**cell_height**h]h cell_height}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj3ubhX is the height of the character cell as displayed by the console. The argument given in }(hj3hhhNhNubju)}(h**cursor_size**h]h cursor_size}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj3ubh is one of the }(hj3hhhNhNubj.)}(hCUR_h]hCUR_}hj3sbah}(h]id12ah ]h"]h$]h&]refidid11uh1j.hj3hhhNhNubhS constants. See vc_cursor_valid_size() for how to get a valid cursor-size constant.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMahj3ubh)}(h **Return**h]ju)}(hj3h]hReturn}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj3ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMfhj3ubh)}(hJThe index of the first scanline after the cursor within the character cellh]hJThe index of the first scanline after the cursor within the character cell}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMghj3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j__vc_resize (C function) c.__vc_resizehNtauh1jhj!hhhNhNubj)}(hhh](j)}(hZint __vc_resize (struct vc_data *vc, unsigned int cols, unsigned int rows, bool from_user)h]j)}(hYint __vc_resize(struct vc_data *vc, unsigned int cols, unsigned int rows, bool from_user)h](j!)}(hinth]hint}(hjA4hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj=4hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMubj)}(h h]h }(hjP4hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj=4hhhjO4hMubj)}(h __vc_resizeh]j)}(h __vc_resizeh]h __vc_resize}(hjb4hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj^4ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj=4hhhjO4hMubj")}(hJ(struct vc_data *vc, unsigned int cols, unsigned int rows, bool from_user)h](j")}(hstruct vc_data *vch](j)}(hjh]hstruct}(hj~4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjz4ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjz4ubh)}(hhh]j)}(hvc_datah]hvc_data}(hj4hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj4modnameN classnameNj+ j. )}j1 ]jc")}j["jd4sb c.__vc_resizeasbuh1hhjz4ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjz4ubjw")}(hjz"h]h*}(hj4hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hjz4ubj)}(hvch]hvc}(hj4hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjz4ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hjv4ubj")}(hunsigned int colsh](j!)}(hunsignedh]hunsigned}(hj4hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj4ubj)}(h h]h }(hj4hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj4ubj!)}(hinth]hint}(hj 5hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj4ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj4ubj)}(hcolsh]hcols}(hj(5hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hjv4ubj")}(hunsigned int rowsh](j!)}(hunsignedh]hunsigned}(hjA5hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj=5ubj)}(h h]h }(hjO5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj=5ubj!)}(hinth]hint}(hj]5hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj=5ubj)}(h h]h }(hjk5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj=5ubj)}(hrowsh]hrows}(hjy5hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj=5ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hjv4ubj")}(hbool from_userh](j!)}(hboolh]hbool}(hj5hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj5ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj5ubj)}(h from_userh]h from_user}(hj5hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hjv4ubeh}(h]h ]h"]h$]h&]hhuh1j!hj=4hhhjO4hMubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj94hhhjO4hMubah}(h]j44ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjO4hMhj64hhubjC)}(hhh]h)}(h resize a VTh]h resize a VT}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj5hhubah}(h]h ]h"]h$]h&]uh1jBhj64hhhjO4hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej5jfj5jgjhjiuh1jhhhj!hNhNubjk)}(hX**Parameters** ``struct vc_data *vc`` virtual console ``unsigned int cols`` columns ``unsigned int rows`` rows ``bool from_user`` invoked by a user? **Description** Resize a virtual console as seen from the console end of things. We use the common vc_do_resize() method to update the structures. Locking: The caller must hold the console sem to protect console internals and **vc->port.tty**.h](h)}(h**Parameters**h]ju)}(hj5h]h Parameters}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj5ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj5ubj)}(hhh](j)}(h'``struct vc_data *vc`` virtual console h](j)}(h``struct vc_data *vc``h]j)}(hj6h]hstruct vc_data *vc}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj6ubj)}(hhh]h)}(hvirtual consoleh]hvirtual console}(hj26hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.6hMhj/6ubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhj.6hMhj6ubj)}(h``unsigned int cols`` columns h](j)}(h``unsigned int cols``h]j)}(hjR6h]hunsigned int cols}(hjT6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjP6ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhjL6ubj)}(hhh]h)}(hcolumnsh]hcolumns}(hjk6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjg6hMhjh6ubah}(h]h ]h"]h$]h&]uh1jhjL6ubeh}(h]h ]h"]h$]h&]uh1jhjg6hMhj6ubj)}(h``unsigned int rows`` rows h](j)}(h``unsigned int rows``h]j)}(hj6h]hunsigned int rows}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj6ubj)}(hhh]h)}(hrowsh]hrows}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6hMhj6ubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhj6hMhj6ubj)}(h&``bool from_user`` invoked by a user? h](j)}(h``bool from_user``h]j)}(hj6h]hbool from_user}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj6ubj)}(hhh]h)}(hinvoked by a user?h]hinvoked by a user?}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj6hMhj6ubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhj6hMhj6ubeh}(h]h ]h"]h$]h&]uh1jhj5ubh)}(h**Description**h]ju)}(hj6h]h Description}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj6ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj5ubh)}(hResize a virtual console as seen from the console end of things. We use the common vc_do_resize() method to update the structures.h]hResize a virtual console as seen from the console end of things. We use the common vc_do_resize() method to update the structures.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj5ubh)}(h`Locking: The caller must hold the console sem to protect console internals and **vc->port.tty**.h](hOLocking: The caller must hold the console sem to protect console internals and }(hj$7hhhNhNubju)}(h**vc->port.tty**h]h vc->port.tty}(hj,7hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj$7ubh.}(hj$7hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj5ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcon_is_bound (C function)c.con_is_boundhNtauh1jhj!hhhNhNubj)}(hhh](j)}(h*int con_is_bound (const struct consw *csw)h]j)}(h)int con_is_bound(const struct consw *csw)h](j!)}(hinth]hint}(hje7hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hja7hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMdubj)}(h h]h }(hjt7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhja7hhhjs7hMdubj)}(h con_is_boundh]j)}(h con_is_boundh]h con_is_bound}(hj7hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj7ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhja7hhhjs7hMdubj")}(h(const struct consw *csw)h]j")}(hconst struct consw *cswh](j)}(hj "h]hconst}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj7ubj)}(hjh]hstruct}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj7ubh)}(hhh]j)}(hconswh]hconsw}(hj7hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj7modnameN classnameNj+ j. )}j1 ]jc")}j["j7sbc.con_is_boundasbuh1hhj7ubj)}(h h]h }(hj7hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj7ubjw")}(hjz"h]h*}(hj 8hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hj7ubj)}(hcswh]hcsw}(hj8hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj7ubah}(h]h ]h"]h$]h&]hhuh1j!hja7hhhjs7hMdubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj]7hhhjs7hMdubah}(h]jX7ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjs7hMdhjZ7hhubjC)}(hhh]h)}(h(checks if driver is bound to the consoleh]h(checks if driver is bound to the console}(hj@8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMdhj=8hhubah}(h]h ]h"]h$]h&]uh1jBhjZ7hhhjs7hMdubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejX8jfjX8jgjhjiuh1jhhhj!hNhNubjk)}(h**Parameters** ``const struct consw *csw`` console driver **Return** zero if unbound, nonzero if bound **Description** Drivers can call this and if zero, they should release all resources allocated on :c:type:`consw.con_startup\(\) `h](h)}(h**Parameters**h]ju)}(hjb8h]h Parameters}(hjd8hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj`8ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhhj\8ubj)}(hhh]j)}(h+``const struct consw *csw`` console driver h](j)}(h``const struct consw *csw``h]j)}(hj8h]hconst struct consw *csw}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMehj{8ubj)}(hhh]h)}(hconsole driverh]hconsole driver}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMehj8ubah}(h]h ]h"]h$]h&]uh1jhj{8ubeh}(h]h ]h"]h$]h&]uh1jhj8hMehjx8ubah}(h]h ]h"]h$]h&]uh1jhj\8ubh)}(h **Return**h]ju)}(hj8h]hReturn}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj8ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMghj\8ubh)}(h!zero if unbound, nonzero if boundh]h!zero if unbound, nonzero if bound}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMghj\8ubh)}(h**Description**h]ju)}(hj8h]h Description}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj8ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMihj\8ubh)}(hyDrivers can call this and if zero, they should release all resources allocated on :c:type:`consw.con_startup\(\) `h](hRDrivers can call this and if zero, they should release all resources allocated on }(hj8hhhNhNubh)}(h':c:type:`consw.con_startup\(\) `h]j)}(hj9h]hconsw.con_startup()}(hj9hhhNhNubah}(h]h ](j j_c-typeeh"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&]refdocj% refdomainj_reftypetype refexplicitrefwarnj+ j/ j3 conswuh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhhj8ubeh}(h]h ]h"]h$]h&]uh1hhj 9hMhhj\8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcon_is_visible (C function)c.con_is_visiblehNtauh1jhj!hhhNhNubj)}(hhh](j)}(h.bool con_is_visible (const struct vc_data *vc)h]j)}(h-bool con_is_visible(const struct vc_data *vc)h](j!)}(hj5h]hbool}(hjG9hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hjC9hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM~ubj)}(h h]h }(hjU9hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjC9hhhjT9hM~ubj)}(hcon_is_visibleh]j)}(hcon_is_visibleh]hcon_is_visible}(hjg9hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjc9ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjC9hhhjT9hM~ubj")}(h(const struct vc_data *vc)h]j")}(hconst struct vc_data *vch](j)}(hj "h]hconst}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj9ubj)}(hjh]hstruct}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj9ubh)}(hhh]j)}(hvc_datah]hvc_data}(hj9hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj9modnameN classnameNj+ j. )}j1 ]jc")}j["ji9sbc.con_is_visibleasbuh1hhj9ubj)}(h h]h }(hj9hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj9ubjw")}(hjz"h]h*}(hj9hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hj9ubj)}(hvch]hvc}(hj9hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj{9ubah}(h]h ]h"]h$]h&]hhuh1j!hjC9hhhjT9hM~ubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj?9hhhjT9hM~ubah}(h]j:9ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjT9hM~hj<9hhubjC)}(hhh]h)}(h-checks whether the current console is visibleh]h-checks whether the current console is visible}(hj!:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM~hj:hhubah}(h]h ]h"]h$]h&]uh1jBhj<9hhhjT9hM~ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej9:jfj9:jgjhjiuh1jhhhj!hNhNubjk)}(hs**Parameters** ``const struct vc_data *vc`` virtual console **Return** zero if not visible, nonzero if visibleh](h)}(h**Parameters**h]ju)}(hjC:h]h Parameters}(hjE:hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjA:ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj=:ubj)}(hhh]j)}(h-``const struct vc_data *vc`` virtual console h](j)}(h``const struct vc_data *vc``h]j)}(hjb:h]hconst struct vc_data *vc}(hjd:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj`:ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj\:ubj)}(hhh]h)}(hvirtual consoleh]hvirtual console}(hj{:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjw:hMhjx:ubah}(h]h ]h"]h$]h&]uh1jhj\:ubeh}(h]h ]h"]h$]h&]uh1jhjw:hMhjY:ubah}(h]h ]h"]h$]h&]uh1jhj=:ubh)}(h **Return**h]ju)}(hj:h]hReturn}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj:ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj=:ubh)}(h'zero if not visible, nonzero if visibleh]h'zero if not visible, nonzero if visible}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj=:ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcon_debug_enter (C function)c.con_debug_enterhNtauh1jhj!hhhNhNubj)}(hhh](j)}(h)void con_debug_enter (struct vc_data *vc)h]j)}(h(void con_debug_enter(struct vc_data *vc)h](j!)}(hvoidh]hvoid}(hj:hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj:hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMubj)}(h h]h }(hj:hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj:hhhj:hMubj)}(hcon_debug_enterh]j)}(hcon_debug_enterh]hcon_debug_enter}(hj;hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj:ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj:hhhj:hMubj")}(h(struct vc_data *vc)h]j")}(hstruct vc_data *vch](j)}(hjh]hstruct}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubj)}(h h]h }(hj,;hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;ubh)}(hhh]j)}(hvc_datah]hvc_data}(hj=;hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj:;ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj?;modnameN classnameNj+ j. )}j1 ]jc")}j["j;sbc.con_debug_enterasbuh1hhj;ubj)}(h h]h }(hj];hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj;ubjw")}(hjz"h]h*}(hjk;hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hj;ubj)}(hvch]hvc}(hjx;hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj;ubah}(h]h ]h"]h$]h&]hhuh1j!hj:hhhj:hMubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj:hhhj:hMubah}(h]j:ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj:hMhj:hhubjC)}(hhh]h)}(h+prepare the console for the kernel debuggerh]h+prepare the console for the kernel debugger}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj;hhubah}(h]h ]h"]h$]h&]uh1jBhj:hhhj:hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej;jfj;jgjhjiuh1jhhhj!hNhNubjk)}(hX**Parameters** ``struct vc_data *vc`` virtual console **Description** Called when the console is taken over by the kernel debugger, this function needs to save the current console state, then put the console into a state suitable for the kernel debugger.h](h)}(h**Parameters**h]ju)}(hj;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj;ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj;ubj)}(hhh]j)}(h'``struct vc_data *vc`` virtual console h](j)}(h``struct vc_data *vc``h]j)}(hj;h]hstruct vc_data *vc}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj;ubj)}(hhh]h)}(hvirtual consoleh]hvirtual console}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hMhj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhj;hMhj;ubah}(h]h ]h"]h$]h&]uh1jhj;ubh)}(h**Description**h]ju)}(hj<h]h Description}(hj <hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj<ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj;ubh)}(hCalled when the console is taken over by the kernel debugger, this function needs to save the current console state, then put the console into a state suitable for the kernel debugger.h]hCalled when the console is taken over by the kernel debugger, this function needs to save the current console state, then put the console into a state suitable for the kernel debugger.}(hj4<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jcon_debug_leave (C function)c.con_debug_leavehNtauh1jhj!hhhNhNubj)}(hhh](j)}(hvoid con_debug_leave (void)h]j)}(hvoid con_debug_leave(void)h](j!)}(hvoidh]hvoid}(hjc<hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj_<hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMubj)}(h h]h }(hjr<hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj_<hhhjq<hMubj)}(hcon_debug_leaveh]j)}(hcon_debug_leaveh]hcon_debug_leave}(hj<hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj<ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj_<hhhjq<hMubj")}(h(void)h]j")}(hvoidh]j!)}(hvoidh]hvoid}(hj<hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj<ubah}(h]h ]h"]h$]h&]noemphhhuh1j"hj<ubah}(h]h ]h"]h$]h&]hhuh1j!hj_<hhhjq<hMubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj[<hhhjq<hMubah}(h]jV<ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjq<hMhjX<hhubjC)}(hhh]h)}(hrestore console stateh]hrestore console state}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj<hhubah}(h]h ]h"]h$]h&]uh1jBhjX<hhhjq<hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej<jfj<jgjhjiuh1jhhhj!hNhNubjk)}(h**Parameters** ``void`` no arguments **Description** Restore the console state to what it was before the kernel debugger was invoked.h](h)}(h**Parameters**h]ju)}(hj<h]h Parameters}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj<ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj<ubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]j)}(hj =h]hvoid}(hj =hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj =ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj=ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hj$=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj =hKhj!=ubah}(h]h ]h"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]uh1jhj =hKhj=ubah}(h]h ]h"]h$]h&]uh1jhj<ubh)}(h**Description**h]ju)}(hjF=h]h Description}(hjH=hhhNhNubah}(h]h ]h"]h$]h&]uh1jthjD=ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chKhj<ubh)}(hPRestore the console state to what it was before the kernel debugger was invoked.h]hPRestore the console state to what it was before the kernel debugger was invoked.}(hj\=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j%do_unregister_con_driver (C function)c.do_unregister_con_driverhNtauh1jhj!hhhNhNubj)}(hhh](j)}(h6int do_unregister_con_driver (const struct consw *csw)h]j)}(h5int do_unregister_con_driver(const struct consw *csw)h](j!)}(hinth]hint}(hj=hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj=hhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMubj)}(h h]h }(hj=hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj=hhhj=hMubj)}(hdo_unregister_con_driverh]j)}(hdo_unregister_con_driverh]hdo_unregister_con_driver}(hj=hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj=ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj=hhhj=hMubj")}(h(const struct consw *csw)h]j")}(hconst struct consw *cswh](j)}(hj "h]hconst}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj=ubj)}(hjh]hstruct}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubj)}(h h]h }(hj=hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj=ubh)}(hhh]j)}(hconswh]hconsw}(hj>hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj>modnameN classnameNj+ j. )}j1 ]jc")}j["j=sbc.do_unregister_con_driverasbuh1hhj=ubj)}(h h]h }(hj!>hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj=ubjw")}(hjz"h]h*}(hj/>hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hj=ubj)}(hcswh]hcsw}(hj<>hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj=ubah}(h]h ]h"]h$]h&]hhuh1j!hj=hhhj=hMubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj=hhhj=hMubah}(h]j~=ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj=hMhj=hhubjC)}(hhh]h)}(h,unregister console driver from console layerh]h,unregister console driver from console layer}(hjf>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhjc>hhubah}(h]h ]h"]h$]h&]uh1jBhj=hhhj=hMubeh}(h]h ](j_functioneh"]h$]h&]jdj_jej~>jfj~>jgjhjiuh1jhhhj!hNhNubjk)}(hXv**Parameters** ``const struct consw *csw`` console driver **Description** All drivers that registers to the console layer must call this function upon exit, or if the console driver is in a state where it won't be able to handle console services, such as the framebuffer console without loaded framebuffer drivers. The driver must unbind first prior to unregistration.h](h)}(h**Parameters**h]ju)}(hj>h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj>ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM hj>ubj)}(hhh]j)}(h+``const struct consw *csw`` console driver h](j)}(h``const struct consw *csw``h]j)}(hj>h]hconst struct consw *csw}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj>ubj)}(hhh]h)}(hconsole driverh]hconsole driver}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hMhj>ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhj>hMhj>ubah}(h]h ]h"]h$]h&]uh1jhj>ubh)}(h**Description**h]ju)}(hj>h]h Description}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jthj>ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj>ubh)}(hAll drivers that registers to the console layer must call this function upon exit, or if the console driver is in a state where it won't be able to handle console services, such as the framebuffer console without loaded framebuffer drivers.h]hAll drivers that registers to the console layer must call this function upon exit, or if the console driver is in a state where it won’t be able to handle console services, such as the framebuffer console without loaded framebuffer drivers.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chMhj>ubh)}(h5The driver must unbind first prior to unregistration.h]h5The driver must unbind first prior to unregistration.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:36: ./drivers/tty/vt/vt.chM hj>ubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj!hhhNhNubh)}(hhh](h)}(h Internalsh]h Internals}(hj ?hhhNhNubah}(h]h ]h"]h$]h&]jjuh1hhj?hhhhhK(ubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jsel_loadlut (C function) c.sel_loadluthNtauh1jhj?hhhNhNubj)}(hhh](j)}(h!int sel_loadlut (u32 __user *lut)h]j)}(h int sel_loadlut(u32 __user *lut)h](j!)}(hinth]hint}(hjG?hhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hjC?hhha/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:42: ./drivers/tty/vt/selection.chKsubj)}(h h]h }(hjV?hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjC?hhhjU?hKsubj)}(h sel_loadluth]j)}(h sel_loadluth]h sel_loadlut}(hjh?hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjd?ubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjC?hhhjU?hKsubj")}(h(u32 __user *lut)h]j")}(hu32 __user *luth](h)}(hhh]j)}(hu32h]hu32}(hj?hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetj?modnameN classnameNj+ j. )}j1 ]jc")}j["jj?sb c.sel_loadlutasbuh1hhj?ubj)}(h h]h }(hj?hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj?ubh__user}(hj?hhhNhNubj)}(h h]h }(hj?hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj?ubjw")}(hjz"h]h*}(hj?hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hj?ubj)}(hluth]hlut}(hj?hhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj|?ubah}(h]h ]h"]h$]h&]hhuh1j!hjC?hhhjU?hKsubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hj??hhhjU?hKsubah}(h]j:?ah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjU?hKshjHubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMhj:Hubj)}(hhh](j)}(h)``struct tty_struct *tty`` tty to resize h](j)}(h``struct tty_struct *tty``h]j)}(hj_Hh]hstruct tty_struct *tty}(hjaHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]Hubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMhjYHubj)}(hhh]h)}(h tty to resizeh]h tty to resize}(hjxHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjtHhMhjuHubah}(h]h ]h"]h$]h&]uh1jhjYHubeh}(h]h ]h"]h$]h&]uh1jhjtHhMhjVHubj)}(h*``struct winsize *ws`` winsize attributes h](j)}(h``struct winsize *ws``h]j)}(hjHh]hstruct winsize *ws}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjHubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMhjHubj)}(hhh]h)}(hwinsize attributesh]hwinsize attributes}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhMhjHubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjHhMhjVHubeh}(h]h ]h"]h$]h&]uh1jhj:Hubh)}(h**Description**h]ju)}(hjHh]h Description}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjHubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMhj:Hubh)}(hResize a virtual terminal. This is called by the tty layer as we register our own handler for resizing. The mutual helper does all the actual work.h]hResize a virtual terminal. This is called by the tty layer as we register our own handler for resizing. The mutual helper does all the actual work.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMhj:Hubh)}(hzLocking: Takes the console sem and the called methods then take the tty termios_rwsem and the tty ctrl.lock in that order.h]hzLocking: Takes the console sem and the called methods then take the tty termios_rwsem and the tty ctrl.lock in that order.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMhj:Hubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj?hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jvc_ctl_state (C enum)c.vc_ctl_statehNtauh1jhj?hhhNhNubj)}(hhh](j)}(h vc_ctl_stateh]j)}(henum vc_ctl_stateh](j)}(hjh]henum}(hj'IhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#IhhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMubj)}(h h]h }(hj5IhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj#Ihhhj4IhMubj)}(h vc_ctl_stateh]j)}(hj!Ih]h vc_ctl_state}(hjGIhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjCIubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhj#Ihhhj4IhMubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjIhhhj4IhMubah}(h]jIah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhj4IhMhjIhhubjC)}(hhh]h)}(h control characters state of a vth]h control characters state of a vt}(hjiIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjfIhhubah}(h]h ]h"]h$]h&]uh1jBhjIhhhj4IhMubeh}(h]h ](j_enumeh"]h$]h&]jdj_jejIjfjIjgjhjiuh1jhhhj?hNhNubjk)}(hX**Constants** ``ESnormal`` initial state, no control characters parsed ``ESesc`` ESC parsed ``ESsquare`` CSI parsed -- modifiers/parameters/ctrl chars expected ``ESgetpars`` CSI parsed -- parameters/ctrl chars expected ``ESgetsubpars`` CSI m parsed -- subparameters expected ``ESfunckey`` CSI [ parsed ``EShash`` ESC # parsed ``ESsetG0`` ESC ( parsed ``ESsetG1`` ESC ) parsed ``ESpercent`` ESC % parsed ``EScsiignore`` CSI [0x20-0x3f] parsed ``ESnonstd`` OSC parsed ``ESpalette`` OSC P parsed ``ESosc`` OSC [0-9] parsed ``ESANSI_first`` first state for ignoring ansi control sequences ``ESapc`` ESC _ parsed ``ESpm`` ESC ^ parsed ``ESdcs`` ESC P parsed ``ESANSI_last`` last state for ignoring ansi control sequencesh](h)}(h **Constants**h]ju)}(hjIh]h Constants}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjIubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjIubj)}(hhh](j)}(h9``ESnormal`` initial state, no control characters parsed h](j)}(h ``ESnormal``h]j)}(hjIh]hESnormal}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM! hjIubj)}(hhh]h)}(h+initial state, no control characters parsedh]h+initial state, no control characters parsed}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhM! hjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhM! hjIubj)}(h``ESesc`` ESC parsed h](j)}(h ``ESesc``h]j)}(hjIh]hESesc}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM$ hjIubj)}(hhh]h)}(h ESC parsedh]h ESC parsed}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhM$ hjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhM$ hjIubj)}(hD``ESsquare`` CSI parsed -- modifiers/parameters/ctrl chars expected h](j)}(h ``ESsquare``h]j)}(hjJh]hESsquare}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM' hjJubj)}(hhh]h)}(h6CSI parsed -- modifiers/parameters/ctrl chars expectedh]h6CSI parsed -- modifiers/parameters/ctrl chars expected}(hj5JhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1JhM' hj2Jubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhj1JhM' hjIubj)}(h;``ESgetpars`` CSI parsed -- parameters/ctrl chars expected h](j)}(h ``ESgetpars``h]j)}(hjUJh]h ESgetpars}(hjWJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjSJubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM* hjOJubj)}(hhh]h)}(h,CSI parsed -- parameters/ctrl chars expectedh]h,CSI parsed -- parameters/ctrl chars expected}(hjnJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjJhM* hjkJubah}(h]h ]h"]h$]h&]uh1jhjOJubeh}(h]h ]h"]h$]h&]uh1jhjjJhM* hjIubj)}(h8``ESgetsubpars`` CSI m parsed -- subparameters expected h](j)}(h``ESgetsubpars``h]j)}(hjJh]h ESgetsubpars}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM- hjJubj)}(hhh]h)}(h&CSI m parsed -- subparameters expectedh]h&CSI m parsed -- subparameters expected}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhM- hjJubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjJhM- hjIubj)}(h``ESfunckey`` CSI [ parsed h](j)}(h ``ESfunckey``h]j)}(hjJh]h ESfunckey}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM0 hjJubj)}(hhh]h)}(h CSI [ parsedh]h CSI [ parsed}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhM0 hjJubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjJhM0 hjIubjr)}(h``EShash`` ESC # parsed h](j)}(h ``EShash``h]j)}(hjKh]hEShash}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM3 hjJubj)}(hhh]h)}(h ESC # parsedh]h ESC # parsed}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhM3 hjKubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjKhM3 hjIubj)}(h``ESsetG0`` ESC ( parsed h](j)}(h ``ESsetG0``h]j)}(hj9Kh]hESsetG0}(hj;KhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj7Kubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM6 hj3Kubj)}(hhh]h)}(h ESC ( parsedh]h ESC ( parsed}(hjRKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNKhM6 hjOKubah}(h]h ]h"]h$]h&]uh1jhj3Kubeh}(h]h ]h"]h$]h&]uh1jhjNKhM6 hjIubj)}(h``ESsetG1`` ESC ) parsed h](j)}(h ``ESsetG1``h]j)}(hjrKh]hESsetG1}(hjtKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpKubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM9 hjlKubj)}(hhh]h)}(h ESC ) parsedh]h ESC ) parsed}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhM9 hjKubah}(h]h ]h"]h$]h&]uh1jhjlKubeh}(h]h ]h"]h$]h&]uh1jhjKhM9 hjIubj)}(h``ESpercent`` ESC % parsed h](j)}(h ``ESpercent``h]j)}(hjKh]h ESpercent}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM< hjKubj)}(hhh]h)}(h ESC % parsedh]h ESC % parsed}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhM< hjKubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjKhM< hjIubj)}(h'``EScsiignore`` CSI [0x20-0x3f] parsed h](j)}(h``EScsiignore``h]j)}(hjKh]h EScsiignore}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM? hjKubj)}(hhh]h)}(hCSI [0x20-0x3f] parsedh]hCSI [0x20-0x3f] parsed}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhM? hjKubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjKhM? hjIubj)}(h``ESnonstd`` OSC parsed h](j)}(h ``ESnonstd``h]j)}(hjLh]hESnonstd}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMB hjLubj)}(hhh]h)}(h OSC parsedh]h OSC parsed}(hj6LhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2LhMB hj3Lubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhj2LhMB hjIubj)}(h``ESpalette`` OSC P parsed h](j)}(h ``ESpalette``h]j)}(hjVLh]h ESpalette}(hjXLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTLubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chME hjPLubj)}(hhh]h)}(h OSC P parsedh]h OSC P parsed}(hjoLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjkLhME hjlLubah}(h]h ]h"]h$]h&]uh1jhjPLubeh}(h]h ]h"]h$]h&]uh1jhjkLhME hjIubj)}(h``ESosc`` OSC [0-9] parsed h](j)}(h ``ESosc``h]j)}(hjLh]hESosc}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMH hjLubj)}(hhh]h)}(hOSC [0-9] parsedh]hOSC [0-9] parsed}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhMH hjLubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjLhMH hjIubj)}(hA``ESANSI_first`` first state for ignoring ansi control sequences h](j)}(h``ESANSI_first``h]j)}(hjLh]h ESANSI_first}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMK hjLubj)}(hhh]h)}(h/first state for ignoring ansi control sequencesh]h/first state for ignoring ansi control sequences}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhMK hjLubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjLhMK hjIubj)}(h``ESapc`` ESC _ parsed h](j)}(h ``ESapc``h]j)}(hjMh]hESapc}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMN hjLubj)}(hhh]h)}(h ESC _ parsedh]h ESC _ parsed}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMN hjMubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjMhMN hjIubj)}(h``ESpm`` ESC ^ parsed h](j)}(h``ESpm``h]j)}(hj:Mh]hESpm}(hj``ESANSI_last`` last state for ignoring ansi control sequencesh](j)}(h``ESANSI_last``h]j)}(hjMh]h ESANSI_last}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMV hjMubj)}(hhh]h)}(h.last state for ignoring ansi control sequencesh]h.last state for ignoring ansi control sequences}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chMW hjMubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjMhMV hjIubeh}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj?hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j vc_sanitize_unicode (C function)c.vc_sanitize_unicodehNtauh1jhj?hhhNhNubj)}(hhh](j)}(h%int vc_sanitize_unicode (const int c)h]j)}(h$int vc_sanitize_unicode(const int c)h](j!)}(hinth]hint}(hjNhhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hjNhhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM ubj)}(h h]h }(hjNhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjNhhhjNhM ubj)}(hvc_sanitize_unicodeh]j)}(hvc_sanitize_unicodeh]hvc_sanitize_unicode}(hj'NhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj#Nubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjNhhhjNhM ubj")}(h (const int c)h]j")}(h const int ch](j)}(hj "h]hconst}(hjCNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?Nubj)}(h h]h }(hjPNhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj?Nubj!)}(hinth]hint}(hj^NhhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj?Nubj)}(h h]h }(hjlNhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj?Nubj)}(hj_h]hc}(hjzNhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhj?Nubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hj;Nubah}(h]h ]h"]h$]h&]hhuh1j!hjNhhhjNhM ubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjMhhhjNhM ubah}(h]jMah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjNhM hjMhhubjC)}(hhh]h)}(h3Replace invalid Unicode code points with ``U+FFFD``h](h)Replace invalid Unicode code points with }(hjNhhhNhNubj)}(h ``U+FFFD``h]hU+FFFD}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjNhhubah}(h]h ]h"]h$]h&]uh1jBhjMhhhjNhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejNjfjNjgjhjiuh1jhhhj?hNhNubjk)}(h9**Parameters** ``const int c`` the received code pointh](h)}(h**Parameters**h]ju)}(hjNh]h Parameters}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjNubj)}(hhh]j)}(h'``const int c`` the received code pointh](j)}(h``const int c``h]j)}(hjNh]h const int c}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjNubj)}(hhh]h)}(hthe received code pointh]hthe received code point}(hj OhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjOubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]uh1jhjOhM hjNubah}(h]h ]h"]h$]h&]uh1jhjNubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj?hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!vc_translate_unicode (C function)c.vc_translate_unicodehNtauh1jhj?hhhNhNubj)}(hhh](j)}(hBint vc_translate_unicode (struct vc_data *vc, int c, bool *rescan)h]j)}(hAint vc_translate_unicode(struct vc_data *vc, int c, bool *rescan)h](j!)}(hinth]hint}(hjLOhhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hjHOhhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM ubj)}(h h]h }(hj[OhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjHOhhhjZOhM ubj)}(hvc_translate_unicodeh]j)}(hvc_translate_unicodeh]hvc_translate_unicode}(hjmOhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjiOubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjHOhhhjZOhM ubj")}(h)(struct vc_data *vc, int c, bool *rescan)h](j")}(hstruct vc_data *vch](j)}(hjh]hstruct}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjOubh)}(hhh]j)}(hvc_datah]hvc_data}(hjOhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainj_reftypej[" reftargetjOmodnameN classnameNj+ j. )}j1 ]jc")}j["joOsbc.vc_translate_unicodeasbuh1hhjOubj)}(h h]h }(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjOubjw")}(hjz"h]h*}(hjOhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jv"hjOubj)}(hvch]hvc}(hjOhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hjOubj")}(hint ch](j!)}(hinth]hint}(hjOhhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hjOubj)}(h h]h }(hj PhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjOubj)}(hj_h]hc}(hjPhhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hjOubj")}(h bool *rescanh](j!)}(hj5h]hbool}(hj/PhhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hj+Pubj)}(h h]h }(hj`h](hCombine UTF-8 into Unicode in }(hjPhhhNhNubh)}(h':c:type:`vc_data.vc_utf_char `h]j)}(hjPh]hvc_data.vc_utf_char}(hjPhhhNhNubah}(h]h ](j j_c-typeeh"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]refdocj% refdomainj_reftypetype refexplicitrefwarnj+ j. )}j1 ]jOc.vc_translate_unicodeasbj3 vc_datauh1hhjBChMhjPubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hj~Phhubah}(h]h ]h"]h$]h&]uh1jBhjAOhhhjZOhM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejPjfjPjgjhjiuh1jhhhj?hNhNubjk)}(hX**Parameters** ``struct vc_data *vc`` virtual console ``int c`` UTF-8 byte to translate ``bool *rescan`` set to true iff **c** wasn't consumed here and needs to be re-processed **Description** * :c:type:`vc_data.vc_utf_char ` is the being-constructed Unicode code point. * :c:type:`vc_data.vc_utf_count ` is the number of continuation bytes still expected to arrive. * :c:type:`vc_data.vc_npar ` is the number of continuation bytes arrived so far. **Return** * ``-1`` - Input OK so far, **c** consumed, further bytes expected. * ``0xFFFD`` - Possibility 1: input invalid, **c** may have been consumed (see desc. of **rescan**). Possibility 2: input OK, **c** consumed, ``U+FFFD`` is the resulting code point. ``U+FFFD`` is valid, ``REPLACEMENT CHARACTER``. * otherwise - Input OK, **c** consumed, resulting code point returned.h](h)}(h**Parameters**h]ju)}(hjPh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjPubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjPubj)}(hhh](j)}(h'``struct vc_data *vc`` virtual console h](j)}(h``struct vc_data *vc``h]j)}(hjPh]hstruct vc_data *vc}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjPubj)}(hhh]h)}(hvirtual consoleh]hvirtual console}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhM hjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhM hjPubj)}(h"``int c`` UTF-8 byte to translate h](j)}(h ``int c``h]j)}(hjQh]hint c}(hj!QhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjQubj)}(hhh]h)}(hUTF-8 byte to translateh]hUTF-8 byte to translate}(hj8QhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4QhM hj5Qubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhj4QhM hjPubj)}(hY``bool *rescan`` set to true iff **c** wasn't consumed here and needs to be re-processed h](j)}(h``bool *rescan``h]j)}(hjXQh]h bool *rescan}(hjZQhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjVQubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjRQubj)}(hhh]h)}(hGset to true iff **c** wasn't consumed here and needs to be re-processedh](hset to true iff }(hjqQhhhNhNubju)}(h**c**h]hc}(hjyQhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjqQubh4 wasn’t consumed here and needs to be re-processed}(hjqQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjmQhM hjnQubah}(h]h ]h"]h$]h&]uh1jhjRQubeh}(h]h ]h"]h$]h&]uh1jhjmQhM hjPubeh}(h]h ]h"]h$]h&]uh1jhjPubh)}(h**Description**h]ju)}(hjQh]h Description}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjQubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjPubh)}(hhh](h)}(hT:c:type:`vc_data.vc_utf_char ` is the being-constructed Unicode code point.h]h)}(hjQh](h)}(h':c:type:`vc_data.vc_utf_char `h]j)}(hjQh]hvc_data.vc_utf_char}(hjQhhhNhNubah}(h]h ](j j_c-typeeh"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]refdocj% refdomainj_reftypetype refexplicitrefwarnj+ j/ j3 vc_datauh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjQubh- is the being-constructed Unicode code point.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjQhM hjQubah}(h]h ]h"]h$]h&]uh1hhjQubh)}(hf:c:type:`vc_data.vc_utf_count ` is the number of continuation bytes still expected to arrive.h]h)}(hf:c:type:`vc_data.vc_utf_count ` is the number of continuation bytes still expected to arrive.h](h)}(h(:c:type:`vc_data.vc_utf_count `h]j)}(hjQh]hvc_data.vc_utf_count}(hjRhhhNhNubah}(h]h ](j j_c-typeeh"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&]refdocj% refdomainj_reftypetype refexplicitrefwarnj+ j/ j3 vc_datauh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjQubh> is the number of continuation bytes still expected to arrive.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjRhM hjQubah}(h]h ]h"]h$]h&]uh1hhjQubh)}(hX:c:type:`vc_data.vc_npar ` is the number of continuation bytes arrived so far. h]h)}(hW:c:type:`vc_data.vc_npar ` is the number of continuation bytes arrived so far.h](h)}(h#:c:type:`vc_data.vc_npar `h]j)}(hj7Rh]hvc_data.vc_npar}(hj9RhhhNhNubah}(h]h ](j j_c-typeeh"]h$]h&]uh1jhj5Rubah}(h]h ]h"]h$]h&]refdocj% refdomainj_reftypetype refexplicitrefwarnj+ j/ j3 vc_datauh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hj1Rubh4 is the number of continuation bytes arrived so far.}(hj1RhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjTRhM hj-Rubah}(h]h ]h"]h$]h&]uh1hhjQubeh}(h]h ]h"]h$]h&]bulletjz"uh1hhjQhM hjPubh)}(h **Return**h]ju)}(hjnRh]hReturn}(hjpRhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjlRubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjPubh)}(hhh](h)}(hA``-1`` - Input OK so far, **c** consumed, further bytes expected.h]h)}(hjRh](j)}(h``-1``h]h-1}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh - Input OK so far, }(hjRhhhNhNubju)}(h**c**h]hc}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjRubh" consumed, further bytes expected.}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjRubah}(h]h ]h"]h$]h&]uh1hhjRubh)}(hX``0xFFFD`` - Possibility 1: input invalid, **c** may have been consumed (see desc. of **rescan**). Possibility 2: input OK, **c** consumed, ``U+FFFD`` is the resulting code point. ``U+FFFD`` is valid, ``REPLACEMENT CHARACTER``.h]j)}(hhh]j)}(h``0xFFFD`` - Possibility 1: input invalid, **c** may have been consumed (see desc. of **rescan**). Possibility 2: input OK, **c** consumed, ``U+FFFD`` is the resulting code point. ``U+FFFD`` is valid, ``REPLACEMENT CHARACTER``.h](j)}(hL``0xFFFD`` - Possibility 1: input invalid, **c** may have been consumed (seeh](j)}(h ``0xFFFD``h]h0xFFFD}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh! - Possibility 1: input invalid, }(hjRhhhNhNubju)}(h**c**h]hc}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjRubh may have been consumed (see}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjRubj)}(hhh]h)}(hdesc. of **rescan**). Possibility 2: input OK, **c** consumed, ``U+FFFD`` is the resulting code point. ``U+FFFD`` is valid, ``REPLACEMENT CHARACTER``.h](h desc. of }(hjRhhhNhNubju)}(h **rescan**h]hrescan}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jthjRubh). Possibility 2: input OK, }(hjRhhhNhNubju)}(h**c**h]hc}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jthjRubh consumed, }(hjRhhhNhNubj)}(h ``U+FFFD``h]hU+FFFD}(hj(ShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh is the resulting code point. }(hjRhhhNhNubj)}(h ``U+FFFD``h]hU+FFFD}(hj:ShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh is valid, }(hjRhhhNhNubj)}(h``REPLACEMENT CHARACTER``h]hREPLACEMENT CHARACTER}(hjLShhhNhNubah}(h]h ]h"]h$]h&]uh1jhjRubh.}(hjRhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjRubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjRhM hjRubah}(h]h ]h"]h$]h&]uh1jhjRubah}(h]h ]h"]h$]h&]uh1hhjRubh)}(hDotherwise - Input OK, **c** consumed, resulting code point returned.h]h)}(hjSh](hotherwise - Input OK, }(hjShhhNhNubju)}(h**c**h]hc}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1jthjSubh) consumed, resulting code point returned.}(hjShhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hj}Subah}(h]h ]h"]h$]h&]uh1hhjRubeh}(h]h ]h"]h$]h&]jkRjz"uh1hhjRhM hjPubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj?hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jvt_kmsg_redirect (C function)c.vt_kmsg_redirecthNtauh1jhj?hhhNhNubj)}(hhh](j)}(hint vt_kmsg_redirect (int new)h]j)}(hint vt_kmsg_redirect(int new)h](j!)}(hinth]hint}(hjShhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hjShhhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM ubj)}(h h]h }(hjShhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjShhhjShM ubj)}(hvt_kmsg_redirecth]j)}(hvt_kmsg_redirecth]hvt_kmsg_redirect}(hjShhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjSubah}(h]h ](j)j*eh"]h$]h&]hhuh1jhjShhhjShM ubj")}(h (int new)h]j")}(hint newh](j!)}(hinth]hint}(hj ThhhNhNubah}(h]h ]j!ah"]h$]h&]uh1j!hjTubj)}(h h]h }(hjThhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjTubj)}(hnewh]hnew}(hj&ThhhNhNubah}(h]h ]j"ah"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]noemphhhuh1j"hjTubah}(h]h ]h"]h$]h&]hhuh1j!hjShhhjShM ubeh}(h]h ]h"]h$]h&]hhj4uh1jj5j6hjShhhjShM ubah}(h]jSah ](j:j;eh"]h$]h&]j?j@)jAhuh1jhjShM hjShhubjC)}(hhh]h)}(h$sets/gets the kernel message consoleh]h$sets/gets the kernel message console}(hjPThhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjMThhubah}(h]h ]h"]h$]h&]uh1jBhjShhhjShM ubeh}(h]h ](j_functioneh"]h$]h&]jdj_jejhTjfjhTjgjhjiuh1jhhhj?hNhNubjk)}(hX`**Parameters** ``int new`` the new virtual terminal number or -1 if the console should stay unchanged **Description** By default, the kernel messages are always printed on the current virtual console. However, the user may modify that default with the ``TIOCL_SETKMSGREDIRECT`` ioctl call. This function sets the kernel message console to be **new**. It returns the old virtual console number. The virtual terminal number ``0`` (both as parameter and return value) means no redirection (i.e. always printed on the currently active console). The parameter -1 means that only the current console is returned, but the value is not modified. You may use the macro vt_get_kmsg_redirect() in that case to make the code more understandable. When the kernel is compiled without ``CONFIG_VT_CONSOLE``, this function ignores the parameter and always returns ``0``.h](h)}(h**Parameters**h]ju)}(hjrTh]h Parameters}(hjtThhhNhNubah}(h]h ]h"]h$]h&]uh1jthjpTubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjlTubj)}(hhh]j)}(hW``int new`` the new virtual terminal number or -1 if the console should stay unchanged h](j)}(h ``int new``h]j)}(hjTh]hint new}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjTubj)}(hhh]h)}(hJthe new virtual terminal number or -1 if the console should stay unchangedh]hJthe new virtual terminal number or -1 if the console should stay unchanged}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjTubah}(h]h ]h"]h$]h&]uh1jhjTubeh}(h]h ]h"]h$]h&]uh1jhjThM hjTubah}(h]h ]h"]h$]h&]uh1jhjlTubh)}(h**Description**h]ju)}(hjTh]h Description}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jthjTubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjlTubh)}(hBy default, the kernel messages are always printed on the current virtual console. However, the user may modify that default with the ``TIOCL_SETKMSGREDIRECT`` ioctl call.h](hBy default, the kernel messages are always printed on the current virtual console. However, the user may modify that default with the }(hjThhhNhNubj)}(h``TIOCL_SETKMSGREDIRECT``h]hTIOCL_SETKMSGREDIRECT}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubh ioctl call.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjlTubh)}(hThis function sets the kernel message console to be **new**. It returns the old virtual console number. The virtual terminal number ``0`` (both as parameter and return value) means no redirection (i.e. always printed on the currently active console).h](h4This function sets the kernel message console to be }(hjUhhhNhNubju)}(h**new**h]hnew}(hj UhhhNhNubah}(h]h ]h"]h$]h&]uh1jthjUubhI. It returns the old virtual console number. The virtual terminal number }(hjUhhhNhNubj)}(h``0``h]h0}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjUubhq (both as parameter and return value) means no redirection (i.e. always printed on the currently active console).}(hjUhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjlTubh)}(hThe parameter -1 means that only the current console is returned, but the value is not modified. You may use the macro vt_get_kmsg_redirect() in that case to make the code more understandable.h]hThe parameter -1 means that only the current console is returned, but the value is not modified. You may use the macro vt_get_kmsg_redirect() in that case to make the code more understandable.}(hj7UhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjlTubh)}(hxWhen the kernel is compiled without ``CONFIG_VT_CONSOLE``, this function ignores the parameter and always returns ``0``.h](h$When the kernel is compiled without }(hjFUhhhNhNubj)}(h``CONFIG_VT_CONSOLE``h]hCONFIG_VT_CONSOLE}(hjNUhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFUubh9, this function ignores the parameter and always returns }(hjFUhhhNhNubj)}(h``0``h]h0}(hj`UhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFUubh.}(hjFUhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/driver-api/tty/console:44: ./drivers/tty/vt/vt.chM hjlTubeh}(h]h ] kernelindentah"]h$]h&]uh1jjhj?hhhNhNubeh}(h]jah ]h"]h$]jah&]uh1hhj!hhhhhK(jKubeh}(h]jqah ]h"]console functionsah$]h&]uh1hhhhhhhhKubeh}(h]consoleah ]h"]consoleah$]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_handlerjUerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _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}cur](h)}(hj/h]hCUR}(hjUhhhNhNubah}(h]h ]h"]h$]h&]nameCURrefnamejUuh1hhj.ubh)}(hjz1h]hCUR}(hj VhhhNhNubah}(h]h ]h"]h$]h&]nameCURj Vcuruh1hhjL1ubh)}(hj3h]hCUR}(hjVhhhNhNubah}(h]h ]h"]h$]h&]nameCURj Vcuruh1hhj3ubesrefids}nameids}(jUjUjjjj internalsNj!jOjUjqu nametypes}(jUjjj.Vj!jUuh}(jUhjhjjjjjj j!j j jjjjjjjjojOjjjjqj!j!j!j=$jB$jS&jX&jn'js'j(j(j)j)j+j+j-j-jh/jm/j1j1j44j94jX7j]7j:9j?9j:j:jV<j[<j~=j=jj?j:?j??j@j@j'Cj,CjFjFjIjIjMjMj?OjDOjSjShhjjjIj@jkjbjjj/hsystem_message)}(hhh]h)}(hhh]hUnknown target name: "cur".}hj7Vsbah}(h]h ]h"]h$]h&]uh1hhj4Vubah}(h]j/ah ]h"]h$]h&]j /alevelKtypeERRORsourcej-/lineMuh1j2Vubj /j/j1j3V)}(hhh]h)}(hhh]hUnknown target name: "cur".}hjRVsbah}(h]h ]h"]h$]h&]uh1hhjOVubah}(h]j1ah ]h"]h$]h&]j1alevelKtypejLVsourcej1lineM=uh1j2Vubj1jx1j3j3V)}(hhh]h)}(hhh]hUnknown target name: "cur".}hjlVsbah}(h]h ]h"]h$]h&]uh1hhjiVubah}(h]j3ah ]h"]h$]h&]j3alevelKtypejLVsourcej3lineMauh1j2Vubj3j3u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jUK sRparse_messages]j3V)}(hhh]h)}(h,Duplicate implicit target name: "internals".h]h0Duplicate implicit target name: “internals”.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVubah}(h]h ]h"]h$]h&]jalevelKtypeINFOsourcehnjlineK(uh1j2Vhj?hhhhhK(ubatransform_messages](j4VjOVjiVe transformerN include_log] decorationNhhub.