TTY: serial, document ignoring of uart->ops->startup error
authorJiri Slaby <jslaby@suse.cz>
Wed, 17 Aug 2011 11:48:15 +0000 (13:48 +0200)
committerGreg Kroah-Hartman <gregkh@suse.de>
Tue, 23 Aug 2011 17:10:38 +0000 (10:10 -0700)
commit0055197e984e5fbe6f48f37fc50dd30254915493
treedf7de31cd63bc231a37fd6833ba53e40140ceff5
parent24d406a6bf736f7aebdc8fa0f0ec86e0890c6d24
TTY: serial, document ignoring of uart->ops->startup error

When a user has SYS_ADMIN capabilities and uart->ops->startup returns
an error in uart_startup, we silently drop the error. We then return 0
and behave as if it didn't fail. (Not quite, since we set TTY_IO_ERROR
bit and leave ASYNC_INITIALIZED bit cleared.)

This all is to allow setserial to work with improperly configured or
unconfigured ports. User can thus set port properties and reconfigure
properly.

This patch only documents this behavior.

Signed-off-by: Jiri Slaby <jslaby@suse.cz>
Cc: Alan Cox <alan@lxorguk.ukuu.org.uk>
Cc: Russel King <linux@arm.linux.org.uk>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
drivers/tty/serial/serial_core.c