1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
.. image:: https://img.shields.io/badge/license-GPL-3.0.svg
.. image:: https://travis-ci.org/jamesodhunt/procenv.svg?branch=master
:target: https://travis-ci.org/jamesodhunt/procenv
.. image:: https://scan.coverity.com/projects/jamesodhunt-procenv/badge.svg
:target: https://scan.coverity.com/projects/jamesodhunt-procenv
:alt: Coverity Scan Build Status
.. image:: https://img.shields.io/badge/donate-flattr-blue.svg
:alt: Donate via flattr
:target: https://flattr.com/profile/jamesodhunt
.. image:: https://img.shields.io/badge/paypal-donate-blue.svg
:alt: Donate via Paypal
:target: https://www.paypal.me/jamesodhunt
=======
procenv
=======
.. raw:: html
<a href="https://asciinema.org/a/118278"><img src="https://asciinema.org/a/118278.png" width="836"/></a>
.. contents::
.. sectnum::
Overview
--------
``procenv`` is a simple command-line utility, written in C and licensed
under the GPL, that dumps all attributes of the environment [#]_ in which
it runs, in well-structured plain ASCII, JSON (YAML), XML or CSV.
It is useful as a test tool, to understand what environment a process
runs in and for system comparison.
``procenv`` runs on the following operating systems:
- Android
- FreeBSD
- GNU Hurd
- GNU Linux
- Minix 3
- NetBSD
- OpenBSD
- OSX
It unashamedly emulates a number of existing system
utilities as it is attempting to be all-encompassing: I wrote it with
the aim of being able to dump "everything" that a process may care about
by simply running a single program (by default). Also, the line of
demarcation between "process", "program" and "system" is slightly
blurry in some aspects. For example ``sysconf(3)`` variables could
arguably be considered system attributes, but procenv shows these too
since they are obviously meant to be queryable by applications.
.. [#] If you find anything missing, please either raise a bug or send a
patch :)
Results
-------
``procenv`` is extremely useful for learning about the environment
software builds in. Often, such systems disallow login, but do allow
access to log files. Handily, ``procenv`` runs a battery of tests on
build including running itself so that the build environment gets
captured in the builds logs themselves. Select a link below and drill
down to the build log to see the ``procenv`` output:
Semaphore-CI
~~~~~~~~~~~~
* https://semaphoreci.com/jamesodhunt/procenv
(Click "Passed", "Job #", then "``make check``" to see output).
Travis-CI
~~~~~~~~~
* https://travis-ci.org/jamesodhunt/procenv
Open Build Service (OBS)
~~~~~~~~~~~~~~~~~~~~~~~~
* https://build.opensuse.org/package/show/home:jamesodhunt:procenv/procenv
If you distro does not yet provide a ``procenv`` package, binary
packages for RHEL, Fedora, Centos, SLES, and Arch Linux are available
from here:
* https://software.opensuse.org/download.html?project=home%3Ajamesodhunt%3Aprocenv&package=procenv
Click on your icon for your distro and follow the instructions.
Note that these packages are "bleeding edge" (generated directly from the github repository).
Ubuntu
~~~~~~
build environment
.................
Click the "twisty" triangle to the left of the release number under a
release name, then click one of the build links (like "``amd64``)":
* https://launchpad.net/ubuntu/+source/procenv
PPA environment
...............
https://code.launchpad.net/~jamesodhunt/+recipe/procenv-daily
Ubuntu Autopkgtest (DEP-8) environment
......................................
* http://autopkgtest.ubuntu.com/packages/p/procenv/
* Old Jenkins system
* https://jenkins.qa.ubuntu.com/view/Wily/view/AutoPkgTest/job/wily-adt-procenv/
* https://jenkins.qa.ubuntu.com/view/Vivid/view/AutoPkgTest/job/vivid-adt-procenv/
* https://jenkins.qa.ubuntu.com/view/Utopic/view/AutoPkgTest/job/utopic-adt-procenv/
* https://jenkins.qa.ubuntu.com/view/Trusty/view/AutoPkgTest/job/trusty-adt-procenv/
The ``sbuild`` tool environment
...............................
``procenv`` gets run from within sbuild via a DEP-8 test:
* http://autopkgtest.ubuntu.com/packages/s/sbuild/
* Old Jenkins system
* https://jenkins.qa.ubuntu.com/view/Wily/view/AutoPkgTest/job/wily-adt-sbuild/
The ``pbuilder`` tool environment
.................................
``procenv`` gets run from within pbuilder via a DEP-8 test:
* http://autopkgtest.ubuntu.com/packages/p/pbuilder/
* Old Jenkins system
* https://jenkins.qa.ubuntu.com/view/Wily/view/AutoPkgTest/job/wily-adt-pbuilder/
Debian
~~~~~~
buildd (and ports buildd) environment
.....................................
* https://buildd.debian.org/status/package.php?p=procenv&suite=sid
Debian autopkgtest (DEP-8) environment
......................................
* http://ci.debian.net/#package/procenv
Fedora
~~~~~~
* https://admin.fedoraproject.org/pkgdb/package/rpms/procenv/
(click "Builds status", click a build, then click one of the "build logs" links).
FreeBSD
~~~~~~~
Logs used to be available, but sadly it appears pointyhat.freebsd.com has
been taken offline (any replacement?)
Gentoo
~~~~~~
* https://packages.gentoo.org/packages/sys-process/procenv/
Porting
-------
Can you help port ``procenv`` to other platforms (AIX, HP-UX, Solaris,
...)? If so, please get in contact.
References
----------
See http://ifdeflinux.blogspot.com/2012/10/procenv-and-process-environment.html
Author
------
``procenv`` was written by James Hunt <jamesodhunt@ubuntu.com>.
Home Page
---------
* https://github.com/jamesodhunt/procenv
|
