procps/proc/escape.h

#ifndef PROCPS_PROC_ESCAPE_H
#define PROCPS_PROC_ESCAPE_H

#include "readproc.h"

#define ESC_ARGS     0x1  // try to use cmdline instead of cmd
#define ESC_BRACKETS 0x2  // if using cmd, put '[' and ']' around it
#define ESC_DEFUNCT  0x4  // mark zombies with " <defunct>"

int escape_command (char *outbuf, const proc_t *pp, int bytes, int *cells, unsigned flags);

int escape_str (char *dst, const char *src, int bufsize, int *maxcells);

#endif
still sig11 w/ "ps f" 2002-12-21 16:04:50 +05:30			`#ifndef PROCPS_PROC_ESCAPE_H`
			`#define PROCPS_PROC_ESCAPE_H`

library: re-arrange escape commands escaped_copy(): only appears in ps, moved to ps/output.c escape_strlist() only used in escape.c made static escape_command() used in library, made internal procps.h no longer includes escape.h escape_str() used by library and ps so needs to be exported definition put into procps.h including the odd define required. Far from ideal to have it this way, will look at it another time to have it all in, all out or split nicer so its not in the API; perhaps a lib/ file? 2016-04-17 10:15:19 +05:30			`#include "readproc.h"`
still sig11 w/ "ps f" 2002-12-21 16:04:50 +05:30
			`#define ESC_ARGS 0x1 // try to use cmdline instead of cmd`
			`#define ESC_BRACKETS 0x2 // if using cmd, put '[' and ']' around it`
			`#define ESC_DEFUNCT 0x4 // mark zombies with " <defunct>"`

library: make that 'escape_str' private to our library In that commit referenced below, a promise was made to revisit an 'escape_str' function in efforts to make it private to the library. The problem was it's needed by both ps plus the library which is why it was exported. So, in an effort to remove it from libprocps.sym, this patch duplicates all the required code in ps/output.c. Now, each version can be made private to their caller. [ along the way we'll use this opportunity to remove ] [ the 'restrict' qualifiers from function parameters ] [ while swatting a compiler warning referenced below ] Reference(s): . April 2016, most escape functions made private commit d916d5db86cbbf552401026aab15c3663412d662 proc/escape.c: In function `escape_command': proc/escape.c:182:23: warning: initialization of `const char ' from incompatible pointer type `char ' [-Wincompatible-pointer-types] 182 \| const char lc = (char)pp->cmdline; \| ^ Signed-off-by: Jim Warner <james.warner@comcast.net> 2020-06-30 10:30:00 +05:30			`int escape_command (char outbuf, const proc_t pp, int bytes, int *cells, unsigned flags);`
still sig11 w/ "ps f" 2002-12-21 16:04:50 +05:30
library: make that 'escape_str' private to our library In that commit referenced below, a promise was made to revisit an 'escape_str' function in efforts to make it private to the library. The problem was it's needed by both ps plus the library which is why it was exported. So, in an effort to remove it from libprocps.sym, this patch duplicates all the required code in ps/output.c. Now, each version can be made private to their caller. [ along the way we'll use this opportunity to remove ] [ the 'restrict' qualifiers from function parameters ] [ while swatting a compiler warning referenced below ] Reference(s): . April 2016, most escape functions made private commit d916d5db86cbbf552401026aab15c3663412d662 proc/escape.c: In function `escape_command': proc/escape.c:182:23: warning: initialization of `const char ' from incompatible pointer type `char ' [-Wincompatible-pointer-types] 182 \| const char lc = (char)pp->cmdline; \| ^ Signed-off-by: Jim Warner <james.warner@comcast.net> 2020-06-30 10:30:00 +05:30			`int escape_str (char dst, const char src, int bufsize, int *maxcells);`
library: eliminated the questionable 'procps.h' header There was a time when that procps.h file served a more traditional role. Prior to the commit referenced below it held just macros plus manifest constants. But, with that change, such items were replaced with a series of includes embracing all the library exported functions. That approach was known to disguise errors which would have otherwise yielded a compiler warning. And without such a warning, there was no way to address the error. So this patch will trade the all inclusive header file approach for individual includes only where necessary. Reference(s): . April 2016, procps.h header file revamped commit ccb6ae8de14b0cde25b84369ef995bcd69cbf7b6 . Sept 2018, top abandoned use of procps.h commit a6dfc2382ed1e023dd345cdb1d2388c9b67bcc7f Signed-off-by: Jim Warner <james.warner@comcast.net> 2020-06-30 10:30:00 +05:30
still sig11 w/ "ps f" 2002-12-21 16:04:50 +05:30			`#endif`