d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update the comments in exec.h with help from jilles.

Browse Source 
PR:		180970
Submitted by:	Carlos Jacobo Puga Medina <cjpugmed@gmail.com>
Reviewed by:	jilles
MFC after:	1 week
This commit is contained in:
Warren Block 2014-08-08 22:30:41 +00:00
parent 45a3069948
commit 353850b7e9
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=269743
1 changed files with 12 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
sys/sys/exec.h
View File

@ -39,12 +39,17 @@
#define _SYS_EXEC_H_
/*
* The following structure is found at the top of the user stack of each
* user process. The ps program uses it to locate argv and environment
* strings. Programs that wish ps to display other information may modify
* it; normally ps_argvstr points to the argv vector, and ps_nargvstr
* is the same as the program's argc. The fields ps_envstr and ps_nenvstr
* are the equivalent for the environment.
* Before ps_args existed, the following structure, found at the top of
* the user stack of each user process, was used by ps(1) to locate
* environment and argv strings. Normally ps_argvstr points to the
* argv vector, and ps_nargvstr is the same as the program's argc. The
* fields ps_envstr and ps_nenvstr are the equivalent for the environment.
*
* Programs should now use setproctitle(3) to change ps output.
* setproctitle() always informs the kernel with sysctl and sets the
* pointers in ps_strings. The kern.proc.args sysctl first tries p_args.
* If p_args is NULL, it then falls back to reading ps_strings and following
* the pointers.
*/
struct ps_strings {
char **ps_argvstr; /* first of 0 or more argument strings */
@ -55,6 +60,7 @@ struct ps_strings {
/*
* Address of ps_strings structure (in user space).
* Prefer the kern.ps_strings or kern.proc.ps_strings sysctls to this constant.
*/
#define PS_STRINGS (USRSTACK - sizeof(struct ps_strings))
#define SPARE_USRSPACE 4096