tty: Fix comments for tty_ldisc_get()
authorPeter Hurley <peter@hurleysoftware.com>
Mon, 11 Jan 2016 06:40:59 +0000 (22:40 -0800)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Wed, 27 Jan 2016 23:01:44 +0000 (15:01 -0800)
tty_ldisc_get() returns ERR_PTR() values if unsuccessful, not NULL;
fix function header documentation.

Signed-off-by: Peter Hurley <peter@hurleysoftware.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
drivers/tty/tty_ldisc.c

index b2e8210..4008f5f 100644 (file)
@@ -140,9 +140,16 @@ static void put_ldops(struct tty_ldisc_ops *ldops)
  *     @disc: ldisc number
  *
  *     Takes a reference to a line discipline. Deals with refcounts and
- *     module locking counts. Returns NULL if the discipline is not available.
- *     Returns a pointer to the discipline and bumps the ref count if it is
- *     available
+ *     module locking counts.
+ *
+ *     Returns: -EINVAL if the discipline index is not [N_TTY..NR_LDISCS] or
+ *                      if the discipline is not registered
+ *              -EAGAIN if request_module() failed to load or register the
+ *                      the discipline
+ *              -ENOMEM if allocation failure
+ *
+ *              Otherwise, returns a pointer to the discipline and bumps the
+ *              ref count
  *
  *     Locking:
  *             takes tty_ldiscs_lock to guard against ldisc races