console: Document struct console

Add kerneldoc comments to struct console.

Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: John Ogness <john.ogness@linutronix.de>
Reviewed-by: Petr Mladek <pmladek@suse.com>
Signed-off-by: Petr Mladek <pmladek@suse.com>
Link: https://lore.kernel.org/r/20230109100800.1085541-4-john.ogness@linutronix.de
This commit is contained in:
Thomas Gleixner 2023-01-09 11:13:55 +01:06 committed by Petr Mladek
parent 717a5651b1
commit 02b2396d7d

@ -164,24 +164,44 @@ enum cons_flags {
CON_EXTENDED = BIT(6), CON_EXTENDED = BIT(6),
}; };
/**
* struct console - The console descriptor structure
* @name: The name of the console driver
* @write: 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
*/
struct console { struct console {
char name[16]; char name[16];
void (*write)(struct console *, const char *, unsigned); void (*write)(struct console *co, const char *s, unsigned int count);
int (*read)(struct console *, char *, unsigned); int (*read)(struct console *co, char *s, unsigned int count);
struct tty_driver *(*device)(struct console *, int *); struct tty_driver *(*device)(struct console *co, int *index);
void (*unblank)(void); void (*unblank)(void);
int (*setup)(struct console *, char *); int (*setup)(struct console *co, char *options);
int (*exit)(struct console *); int (*exit)(struct console *co);
int (*match)(struct console *, char *name, int idx, char *options); int (*match)(struct console *co, char *name, int idx, char *options);
short flags; short flags;
short index; short index;
int cflag; int cflag;
uint ispeed; uint ispeed;
uint ospeed; uint ospeed;
u64 seq; u64 seq;
unsigned long dropped; unsigned long dropped;
void *data; void *data;
struct hlist_node node; struct hlist_node node;
}; };
#ifdef CONFIG_LOCKDEP #ifdef CONFIG_LOCKDEP