Denys Vlasenko 2a2ca93530 login: implement LOGIN_TIMEOUT 3 years ago
..
Config.src 43b17b1cd0 restore documentation on the build config language 6 years ago
Kbuild.src 95dee81a46 loginutils/*: convert to new-style "one file" applets 8 years ago
README 834aba3b72 comment and readme updates 7 years ago
add-remove-shell.c b097a84d62 config: update size information 5 years ago
addgroup.c 6937487be7 libbb: reduce the overhead of single parameter bb_error_msg() calls 4 years ago
adduser.c 6937487be7 libbb: reduce the overhead of single parameter bb_error_msg() calls 4 years ago
chpasswd.c caba1a16ec tweak help texts 3 years ago
cryptpw.c 27ae859c50 cryptpw: typo in usage message 3 years ago
deluser.c 0356607264 deluser: check if specified home is a directory before removing it 3 years ago
getty.c b86a9ed699 use write_str() functions where appropriate 3 years ago
login.c 2a2ca93530 login: implement LOGIN_TIMEOUT 3 years ago
passwd.c 11f1a2553e help text tweaks 3 years ago
su.c 2075aa93e0 libbb: rename run_shell() to exec_shell() 3 years ago
sulogin.c f4f6e5144b libbb: exec_login_shell() - new function 3 years ago
vlock.c 87bd558f3f libbb: bb_do_delay(3) -> pause_after_failed_login(), and stop looping there 3 years ago

README

Getty

??? Should getty open tty with or without O_NONBLOCK?
For serial lines, it means "should getty wait for Carrier Detect pin?"
I checked other getties:

- agetty always uses O_NONBLOCK
- mgetty uses O_NONBLOCK unless run with -b, or as "getty"

??? If we decided to use O_NONBLOCK (perhaps optionally with -b),
when getty should send -I INITSTR data to tty? After open succeeds?
What if we also want to initialize *modem* with some AT commands?

??? Should we check/create /var/lock/LCK..ttyPFX lockfiles?

??? mgetty opens tty but does NOT lock it, then waits for input via
select/poll, and when input is available, it checks lock file.
If it exists, mgetty exits (it assumes someone else uses the line).
If no, it creates the file (lock the tty). Sounds like a good algorithm
to use if we are called with -w...

Getty should establish a new session and process group, and ensure
that tty is a ctty.

??? Should getty ensure that other processes which might have opened
fds to this tty be disconnected? agetty has a -R option which makes
agetty call vhangup() after tty is opened. (Then agetty opens it again,
since it probably vhangup'ed its own fd too).

Getty should leave the tty in approximately the same state as "stty sane"
before it execs login program. Minor things we do conditionally are:
c_iflag |= ICRNL; // if '\r' was used to end username

??? mgetty uses per-tty file to ignore connects, /etc/nologin.ttyxx -
is it useful?

It should be possible to run "getty 0 -" from a shell prompt.
[This currently doesn't work from interactive shell since setsid()
fails in process group leader. The workaround is to run it as a child
of something. sh -c 'getty - 0; true' usually works. Should we fix this?]
It should leave tty in a sane state when it exits (Ctrl-D, -t SEC timeout):
echo should be on, speed, control chars properly set, etc.
(However, it can't restore ctty. The symptom is that "fails in the parent shell after getty exits: /dev/tty can't be opened).

Getty should write LOGIN_PROCESS utmp record before it starts waiting
for username to be entered.

Login

Login should not try to set up tty parameters - apart from switching echo
off while entering password, and switching it back on after.

Login should not leave "echo off" state when it times out reading password
or otherwise terminates (Ctrl-C, Ctrl-D etc).

??? Should login establish a new session and/or process group, and ensure
that tty is a ctty? Without this, running login directly (not via getty)
from e.g. initscript will usually result with a login session without
ctty and without session/pgrp properly created...

It should be possible to run "login [USER]" from a shell prompt,
and it should work (not block/die/error out).
Similarly to getty, it should leave tty in the sane state when it exits.

??? Should login write LOGIN_PROCESS utmp record before it starts waiting
for username/password to be entered?

Login should write USER_PROCESS utmp record just before it is about
to exec user's shell.