ps(1): Update some options' conformance/practice comments

MFC after:      3 days
Sponsored by:   The FreeBSD Foundation
Differential Revision:  https://reviews.freebsd.org/D49621

(cherry picked from commit 2d7f70975b)
This commit is contained in:
Olivier Certner 2025-04-01 13:45:08 +02:00
parent 7219648f60
commit 154ccb0196
No known key found for this signature in database
GPG key ID: 8CA13040971E2627

View file

@ -313,17 +313,24 @@ main(int argc, char *argv[])
break;
case 'g':
#if 0
/*-
* XXX - This SUSv3 behavior is still under debate
* since it conflicts with the (undocumented)
* `-g' option. So we skip it for now.
/*
* XXX - This behavior is still under debate since it
* conflicts with the (undocumented) `-g' option
* and is non-standard. However, it is the
* behavior of most UNIX systems except
* SunOS/Solaris/illumos (see next comment; see
* also comment for '-s' below).
*/
add_list(&pgrplist, optarg);
xkeep_implied = 1;
nselectors++;
break;
#else
/* The historical BSD-ish (from SunOS) behavior. */
/*
* The historical BSD-ish (from SunOS) behavior: Also
* display process group leaders (but we do not filter
* them out).
*/
break; /* no-op */
#endif
case 'H':
@ -376,7 +383,7 @@ main(int argc, char *argv[])
break;
#if 0
case 'R':
/*-
/*
* XXX - This un-standard option is still under
* debate. This is what SUSv3 defines as
* the `-U' option, and while it would be
@ -396,11 +403,13 @@ main(int argc, char *argv[])
break;
#if 0
case 's':
/*-
* XXX - This non-standard option is still under
* debate. This *is* supported on Solaris,
* Linux, and IRIX, but conflicts with `-s'
* on NetBSD and maybe some older BSD's.
/*
* XXX - This non-standard option is still under debate.
* It is supported on Solaris, Linux, IRIX, and
* OpenBSD but conflicts with '-s' on NetBSD. This
* is the same functionality as POSIX option '-g',
* but the cited systems do not provide it under
* '-g', only under '-s'.
*/
add_list(&sesslist, optarg);
xkeep_implied = 1;
@ -417,7 +426,12 @@ main(int argc, char *argv[])
nselectors++;
break;
case 'U':
/* This is what SUSv3 defines as the `-u' option. */
/*
* POSIX says that '-U' should match on real user IDs,
* not effective ones as we are doing here, which is
* normally the behavior of option '-u' according to the
* standard.
*/
add_list(&uidlist, optarg);
xkeep_implied = 1;
nselectors++;
@ -917,7 +931,7 @@ addelem_pid(struct listinfo *inf, const char *elem)
return (1);
}
/*-
/*
* The user can specify a device via one of three formats:
* 1) fully qualified, e.g.: /dev/ttyp0 /dev/console /dev/pts/0
* 2) missing "/dev", e.g.: ttyp0 console pts/0