/ 
App-ppgrep-0.033
River stage one • 1 direct dependent • 1 total dependent
/ ppgrep

NAME

ppgrep - Look up parents' processes based on name and other attributes

VERSION

This document describes version 0.033 of main (from Perl distribution App-ppgrep), released on 2019-11-29.

SYNOPSIS

Usage:

% ppgrep [options] [pattern]

DESCRIPTION

This utility is similar to pgrep except that we only look at our descendants (parent, parent's parent, and so on up to PID 1).

OPTIONS

* marks required options.

Display options

--count, -c

Suppress normal output; instead print a count of matching processes.

--list-full, -a

List the full command line as well as the process ID.

--list-name, -l

List the process name as well as the process ID.

Filtering options

--euid-json=s, -u

Only match processes whose effective user ID is listed. Either the numerical or symbolical value may be used. (JSON-encoded).

See --euid.

--euid=s@

Only match processes whose effective user ID is listed. Either the numerical or symbolical value may be used..

Can be specified multiple times.

--exact, -x

Only match processes whose names (or command line if -f is specified) exactly match the pattern.

--full, -f

The pattern is normally only matched against the process name. When -f is set, the full command line is used..

--group-json=s, -G

Only match processes whose real group ID is listed. Either the numerical or symbolical value may be used. (JSON-encoded).

See --group.

--group=s@

Only match processes whose real group ID is listed. Either the numerical or symbolical value may be used..

Can be specified multiple times.

--inverse

Negates the matching.

--pattern=s

Only match processes whose name/cmdline match the pattern.

--pgroup-json=s, -g

Only match processes in the process group IDs listed (JSON-encoded).

See --pgroup.

--pgroup=s@

Only match processes in the process group IDs listed.

Can be specified multiple times.

--session-json=s, -s

Only match processes whose process session ID is listed (JSON-encoded).

See --session.

--session=s@

Only match processes whose process session ID is listed.

Can be specified multiple times.

--terminal-json=s, -t

Only match processes whose controlling terminal is listed. The terminal name should be specified without the "/dev/" prefix. (JSON-encoded).

See --terminal.

--terminal=s@

Only match processes whose controlling terminal is listed. The terminal name should be specified without the "/dev/" prefix..

Can be specified multiple times.

--uid-json=s, -U

Only match processes whose user ID is listed. Either the numerical or symbolical value may be used. (JSON-encoded).

See --uid.

--uid=s@

Only match processes whose user ID is listed. Either the numerical or symbolical value may be used..

Can be specified multiple times.

Other options

--help, -h, -?

Display help message and exit.

--version, -v

Display program's version and exit.

COMPLETION

The script comes with a companion shell completer script (_ppgrep) for this script.

bash

To activate bash completion for this script, put:

complete -C _ppgrep ppgrep

in your bash startup (e.g. ~/.bashrc). Your next shell session will then recognize tab completion for the command. Or, you can also directly execute the line above in your shell to activate immediately.

It is recommended, however, that you install modules using cpanm-shcompgen which can activate shell completion for scripts immediately.

tcsh

To activate tcsh completion for this script, put:

complete ppgrep 'p/*/`ppgrep`/'

in your tcsh startup (e.g. ~/.tcshrc). Your next shell session will then recognize tab completion for the command. Or, you can also directly execute the line above in your shell to activate immediately.

It is also recommended to install shcompgen (see above).

other shells

For fish and zsh, install shcompgen as described above.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/App-ppgrep.

SOURCE

Source repository is at https://github.com/perlancar/perl-App-ppgrep.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-ppgrep

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

pgrep.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2019 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.