NAME

       procenv - display process environment details

SYNOPSIS

       procenv [OPTION]

DESCRIPTION

       Display details of the process environment in a parseable format.

OPTIONS

       Options shown with a bracketed asterisk '(*)' are non-display options and must preceed any
       other (display) options.

       -a, --meta
              Display meta details.

       -A, --arguments
              Display program arguments.

       -b, --libs
              Display details of linked libraries.  See dl_iterate_phdr(3).

       -B, --libc
              Display standard library details.  See feature_test_macros(7) (Linux).

       -c, --cgroups
              Display cgroup details (Linux only).  See proc(5).

       -C, --cpu
              Display    CPU    and    scheduler    details.     See    kvm_getprocs(3)    (BSD),
              pthread_getaffinity_np(3), sched_getcpu(3) (Linux).

       --crumb-separator=str (*)
              Specify string str as alternate delimiter for crumb format output (default=':').

       -d, --compiler
              Display compiler details.  See cpp(1), cc(1) and feature_test_macros(7) (Linux).

       -e, --environment
              Display environment variables.  See environ(7).

       -E, --semaphores
              Display semaphore details (not queryable on BSD).  See semctl(2).

       --exec (*)
              Treat  non-option  arguments  as  program  to  execute  after running procenv.  See
              exec(3).

       -f, --fds
              Display file descriptor details. Under FreeBSD, file descriptor  capabilities  will
              also  be  displayed  assuming  the kernel has Capsicum support.  See cap_getmode(2)
              (BSD), cap_rights_get(2) (BSD), cap_rights_is_set(3) (BSD), fcntl(2), isatty(5).

       -F, --namespaces
              Display namespace details (Linux only).  See proc(5).

       --file=FILE (*)
              Send output to file FILE (implies --output=file).

       --file-append (*)
              If --file is specifed, append to it rather than overwriting it.

       --format=FORMAT (*)
              Specify output format.  FORMAT may be one of:

              •   crumb ("breadcrumbs").

              •   json (JavaScript Object Notation).

              •   text (plain ASCII text) [default].

              •   xml (Extensible Markup Language).

       -g, --sizeof
              Display sizes of data types.

       -h, --help
              This help text.

       -i, --misc
              Display miscellaneous details.  See umask(P),  getcwd(3),  personality(2)  (Linux),
              proc(5),   prctl(2),   aa_getcon(2)   (Linux),  getpidcon(3)  (Linux),  sysconf(3),
              kvm_getprocs(3) (BSD), getpriority(2).

       --indent (*)
              Number of indent characters to use for each indent (default=2).

       --indent-char=c (*)
              Use character c for indenting (default=' ' (space)).

       -j, --uname
              Display uname details.  See uname(2).

       -k, --clocks
              Display clock details.  See clock_getres(2).

       -l, --limits
              Display limits.  See getrlimit(2).

       -L, --locale
              Display locale details.  See setlocale(3) and locale(7).

       -m, --mounts
              Display mount details.  See getmntent(3) and statfs(2) (Linux),  and  getmntinfo(3)
              (BSD).

       -M, --message-queues
              Display message queue details (not queryable on BSD).  See msgctl(2).

       -n, --confstr
              Display confstr details.  See confstr(5).

       -N, --network
              Display  network  details.  See getifaddrs(3), getnameinfo(3), ip(7), netdevice(7),
              and ioctl(2) (Linux).

       -o, --oom
              Display out-of-memory manager details (Linux only).  See proc(5).

       --output=TYPE (*)
              Send output to alternative location. TYPE can be one of:

              •   file (send output to a file).

              •   stderr (write to standard error).

              •   stdout (write to standard output (default)).

              •   syslog (write to the system log file).

              •   terminal (write to terminal).

       -p, --process
              Display process details.  See getpid(2),  getppid(2),  getresuid(2),  getresgid(2),
              getuid(2),  geteuid(2),  getgid(2), getegid(2), getsid(2), getlogin(3), getpgrp(2),
              ctermid(3), tcgetpgrp(3), tcgetsid(3), getpwuid(3) and getgroups(2).

       -P, --platform
              Display platform details.

       -q, --time
              Display time details.  See clock_gettime(2), localtime(3) and asctime(3).

       -r, --ranges
              Display range of data types.  See limits.h(P).

       -s, --signals
              Display signal details.  See sigaction(2).

       -S, --shared-memory
              Display shared memory details (not queryable on BSD).  See shmctl(2).

       --separator=str (*)
              Specify string str as alternate delimiter for text format output (default=': ').

       -t, --tty
              Display terminal details. On Linux, will also show if  any  attributes  are  locked
              when running as root.  See tcgetattr(3) and  tty_ioctl(4) (Linux).

       -T, --threads
              Display        thread       details.        See       pthread_attr_getstacksize(3),
              pthread_attr_getstacksize(3) and pthread_attr_getguardsize(3).

       -u, --stat
              Display stat details.  See stat(2).

       -U, --rusage
              Display rusage details.  See getrusage(2).

       -v, --version
              Display version details.

       -w, --capabilities
              Display Linux capability details. For FreeBSD  file  descriptor  capabilities,  see
              --file-descriptors.  See prctl(2) (Linux), libcap(3) (Linux).

       -x, --pathconf
              Display pathconf details.  See pathconf(3).

       -y, --sysconf
              Display sysconf details.  See sysconf(3) and posixoptions(7) (Linux).

       -Y, --memory
              Display memory details.  See getpagesize(2), numa(3) (Linux) and numa(7) (Linux).

       -z, --timezone
              Display timezone details.  See tzset(3).

ENVIRONMENT VARIABLES

       The  following  environment  variables  may  be  used  as  aliases  to  their command-line
       counterparts:

       PROCENV_CRUMB_SEPARATOR
              Alternative to --crumb-separator.

       PROCENV_EXEC
              Alternative to --exec.

       PROCENV_FILE
              Alternative to --file.

       PROCENV_FILE_APPEND
              Alternative to --file-append.

       PROCENV_FORMAT
              Alternative to --format.

       PROCENV_INDENT
              Alternative to --indent.

       PROCENV_INDENT_CHAR
              Alternative to --indent-char.

       PROCENV_SEPARATOR
              Alternative to --separator.

       PROCENV_OUTPUT
              Alternative to --output.

NOTES

       •   Options are considered in order, so --output should precede any other option.

       •   If no display option is specified, all details are displayed.

       •   Only one display option may be specified.

       •   Command-line options take priority over environment variables.

       •   All values for --indent-char are literal except '\t' which can be used  to  specify  a
           tab character. The same is true for --separator-char and --crumb-separator but only if
           it is the first character specified.

       •   Specifying a visible indent-char is only (vaguely) meaningful for text output.

       •   If --exec is specified, atleast one non-option argument must also be specified.

       •   Any long option name may be shortened as long as it remains unique.

       •   The crumb output format is designed for easy  parsing:  it  displays  the  data  in  a
           flattened  format  with  each  value  on  a  separate line preceded by all appropriate
           headings which are separated by the current separator.

       •   The --message-queues, --semaphores and --shared-memory options are  not  available  on
           BSD since although the values are queryable, there is no documented method to do so.

EXAMPLES

        # Show limits
        procenv -l

        # Send compiler information to syslog (note the order of the options).
        procenv --output=syslog --compiler

        # Write compiler details direct to the terminal
        procenv --output=terminal --compiler

        # Run a command ('mycmd --arg1 --foo=bar') without creating a new
        # process, but have procenv run first and log its output to a
        # regular file.
        exec procenv --file=/tmp/procenv.log --exec -- mycmd --arg1 --foo=bar

        # The following kernel command-line snippet will cause procenv to
        # write output to first serial tty device and then execute init(8)
        # in debug mode to allow early boot environment to be examined.
        init=/usr/bin/procenv PROCENV_FILE=/dev/ttyS0 PROCENV_EXEC="/sbin/init --debug"

        # Display all data in JSON format using an indent of 4 spaces
        procenv --format=json --indent=4

        # Display all data in XML format using tabs for indents
        procenv --format=xml --indent-char="\t"

        # Display signal details in XML format
        procenv --format=xml --signals

        # Display resource limits in easily-parseable format
        procenv --format=crumb --limits

        # Produce output suitable for importing into a spreadsheet
        procenv --format=crumb --crumb-separator=',' --separator=',' --limits

        # Produce stylised output
        procenv --format=crumb --crumb-separator=' → ' --separator='='

LIMITATIONS

       •   Spaces  within  the  value  of PROCENV_EXEC are treated as delimiters meaning that any
           spaces within a string argument for example will result in incorrect behaviour.

       •   The separator character must be chosen carefully since no check is  performed  on  the
           data to see if it itself contains instances of the separator character.

AUTHORS

       Written by James Hunt <jamesodhunt@ubuntu.com> and Kees Cook <kees@ubuntu.com>.

COPYRIGHT

       Copyright © 2012-2016 James Hunt <jamesodhunt@ubuntu.com> and Kees Cook <kees@ubuntu.com>.
       This  is  free software; see the source for copying conditions.  There is NO warranty; not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

LICENSE

       GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.  There is NO  WARRANTY,
       to the extent permitted by law.

SEE ALSO

       capabilities(7)  (Linux),  capsicum(4)  (BSD),  cc(1),  credentials(7),  date(1),  env(1),
       exec(P), getconf(1), groups(1), ifconfig(8), ip(9), ipcs(1), kill(1),  ldd(1),  locale(1),
       ls(1),  mount(1),  proc(5),  ps(1),  rights(4)(BSD),  sh(1),  stat(1),  stty(1), umask(P),
       uname(1)