busybox/loginutils
Denys Vlasenko 205d48e948 *: add comment about APPLET_ODDNAME format
It confused me more than once

Signed-off-by: Denys Vlasenko <vda.linux@googlemail.com>
2017-01-29 14:57:33 +01:00
..
add-remove-shell.c *: add comment about APPLET_ODDNAME format 2017-01-29 14:57:33 +01:00
addgroup.c Big cleanup in config help and description 2017-01-10 14:58:54 +01:00
adduser.c adduser: help for -G GRP is misleading, fix it 2017-01-26 18:54:12 +01:00
chpasswd.c password utils: improve --help, make DEFAULT_PASSWD_ALGO visible if CHPASSWD 2017-01-20 19:47:49 +01:00
Config.src Big cleanup in config help and description 2017-01-10 14:58:54 +01:00
cryptpw.c password utils: improve --help, make DEFAULT_PASSWD_ALGO visible if CHPASSWD 2017-01-20 19:47:49 +01:00
deluser.c Big cleanup in config help and description 2017-01-10 14:58:54 +01:00
getty.c libbb: consolidate the code to set termios unbuffered mode 2017-01-11 16:17:59 +01:00
Kbuild.src loginutils/*: convert to new-style "one file" applets 2015-10-19 01:20:36 +02:00
login.c Big cleanup in config help and description 2017-01-10 14:58:54 +01:00
passwd.c password utils: improve --help, make DEFAULT_PASSWD_ALGO visible if CHPASSWD 2017-01-20 19:47:49 +01:00
README comment and readme updates 2016-11-04 14:13:58 +01:00
su.c Big cleanup in config help and description 2017-01-10 14:58:54 +01:00
sulogin.c su: expand help; simplify passing of -c CMD to run_shell() 2016-11-03 22:13:08 +01:00
vlock.c libbb: consolidate the code to set termios unbuffered mode 2017-01-11 16:17:59 +01:00

	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 "</dev/tty"
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.