├── .gitignore
├── Dockerfile
├── LICENSE
├── README.md
├── bin
├── k8s-debugbox
└── k8s-debugbox.bat
├── bootstrap.sh
├── box
├── busybox.LICENSE
├── curl.LICENSE
├── install-k8s-debugbox.sh
├── sh
├── toybox.LICENSE
├── uninstall-k8s-debugbox.sh
└── vim.LICENSE
├── create-release.sh
├── install.bat
└── install.sh
/.gitignore:
--------------------------------------------------------------------------------
1 | box/busybox
2 | box/toybox
3 | box/curl
4 | box/cacert.pem
5 | releases
6 |
--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
1 | FROM busybox
2 |
3 | # Download latest k8s-debugbox release
4 | RUN mkdir -p /usr/local/k8s-debugbox && \
5 | wget -qO- $(wget -qO- https://api.github.com/repos/puzzle/k8s-debugbox/releases/latest | \
6 | sed -n 's/.*"browser_download_url": *"\([^"]\+.tar.gz\)".*/\1/p') | \
7 | tar -C /usr/local/k8s-debugbox --strip-components 1 -zxvf -
8 |
9 | CMD ["/bin/sh", "/usr/local/k8s-debugbox/box/install-k8s-debugbox.sh"]
10 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | GNU GENERAL PUBLIC LICENSE
2 | Version 3, 29 June 2007
3 |
4 | Copyright (C) 2007 Free Software Foundation, Inc.
5 | Everyone is permitted to copy and distribute verbatim copies
6 | of this license document, but changing it is not allowed.
7 |
8 | Preamble
9 |
10 | The GNU General Public License is a free, copyleft license for
11 | software and other kinds of works.
12 |
13 | The licenses for most software and other practical works are designed
14 | to take away your freedom to share and change the works. By contrast,
15 | the GNU General Public License is intended to guarantee your freedom to
16 | share and change all versions of a program--to make sure it remains free
17 | software for all its users. We, the Free Software Foundation, use the
18 | GNU General Public License for most of our software; it applies also to
19 | any other work released this way by its authors. You can apply it to
20 | your programs, too.
21 |
22 | When we speak of free software, we are referring to freedom, not
23 | price. Our General Public Licenses are designed to make sure that you
24 | have the freedom to distribute copies of free software (and charge for
25 | them if you wish), that you receive source code or can get it if you
26 | want it, that you can change the software or use pieces of it in new
27 | free programs, and that you know you can do these things.
28 |
29 | To protect your rights, we need to prevent others from denying you
30 | these rights or asking you to surrender the rights. Therefore, you have
31 | certain responsibilities if you distribute copies of the software, or if
32 | you modify it: responsibilities to respect the freedom of others.
33 |
34 | For example, if you distribute copies of such a program, whether
35 | gratis or for a fee, you must pass on to the recipients the same
36 | freedoms that you received. You must make sure that they, too, receive
37 | or can get the source code. And you must show them these terms so they
38 | know their rights.
39 |
40 | Developers that use the GNU GPL protect your rights with two steps:
41 | (1) assert copyright on the software, and (2) offer you this License
42 | giving you legal permission to copy, distribute and/or modify it.
43 |
44 | For the developers' and authors' protection, the GPL clearly explains
45 | that there is no warranty for this free software. For both users' and
46 | authors' sake, the GPL requires that modified versions be marked as
47 | changed, so that their problems will not be attributed erroneously to
48 | authors of previous versions.
49 |
50 | Some devices are designed to deny users access to install or run
51 | modified versions of the software inside them, although the manufacturer
52 | can do so. This is fundamentally incompatible with the aim of
53 | protecting users' freedom to change the software. The systematic
54 | pattern of such abuse occurs in the area of products for individuals to
55 | use, which is precisely where it is most unacceptable. Therefore, we
56 | have designed this version of the GPL to prohibit the practice for those
57 | products. If such problems arise substantially in other domains, we
58 | stand ready to extend this provision to those domains in future versions
59 | of the GPL, as needed to protect the freedom of users.
60 |
61 | Finally, every program is threatened constantly by software patents.
62 | States should not allow patents to restrict development and use of
63 | software on general-purpose computers, but in those that do, we wish to
64 | avoid the special danger that patents applied to a free program could
65 | make it effectively proprietary. To prevent this, the GPL assures that
66 | patents cannot be used to render the program non-free.
67 |
68 | The precise terms and conditions for copying, distribution and
69 | modification follow.
70 |
71 | TERMS AND CONDITIONS
72 |
73 | 0. Definitions.
74 |
75 | "This License" refers to version 3 of the GNU General Public License.
76 |
77 | "Copyright" also means copyright-like laws that apply to other kinds of
78 | works, such as semiconductor masks.
79 |
80 | "The Program" refers to any copyrightable work licensed under this
81 | License. Each licensee is addressed as "you". "Licensees" and
82 | "recipients" may be individuals or organizations.
83 |
84 | To "modify" a work means to copy from or adapt all or part of the work
85 | in a fashion requiring copyright permission, other than the making of an
86 | exact copy. The resulting work is called a "modified version" of the
87 | earlier work or a work "based on" the earlier work.
88 |
89 | A "covered work" means either the unmodified Program or a work based
90 | on the Program.
91 |
92 | To "propagate" a work means to do anything with it that, without
93 | permission, would make you directly or secondarily liable for
94 | infringement under applicable copyright law, except executing it on a
95 | computer or modifying a private copy. Propagation includes copying,
96 | distribution (with or without modification), making available to the
97 | public, and in some countries other activities as well.
98 |
99 | To "convey" a work means any kind of propagation that enables other
100 | parties to make or receive copies. Mere interaction with a user through
101 | a computer network, with no transfer of a copy, is not conveying.
102 |
103 | An interactive user interface displays "Appropriate Legal Notices"
104 | to the extent that it includes a convenient and prominently visible
105 | feature that (1) displays an appropriate copyright notice, and (2)
106 | tells the user that there is no warranty for the work (except to the
107 | extent that warranties are provided), that licensees may convey the
108 | work under this License, and how to view a copy of this License. If
109 | the interface presents a list of user commands or options, such as a
110 | menu, a prominent item in the list meets this criterion.
111 |
112 | 1. Source Code.
113 |
114 | The "source code" for a work means the preferred form of the work
115 | for making modifications to it. "Object code" means any non-source
116 | form of a work.
117 |
118 | A "Standard Interface" means an interface that either is an official
119 | standard defined by a recognized standards body, or, in the case of
120 | interfaces specified for a particular programming language, one that
121 | is widely used among developers working in that language.
122 |
123 | The "System Libraries" of an executable work include anything, other
124 | than the work as a whole, that (a) is included in the normal form of
125 | packaging a Major Component, but which is not part of that Major
126 | Component, and (b) serves only to enable use of the work with that
127 | Major Component, or to implement a Standard Interface for which an
128 | implementation is available to the public in source code form. A
129 | "Major Component", in this context, means a major essential component
130 | (kernel, window system, and so on) of the specific operating system
131 | (if any) on which the executable work runs, or a compiler used to
132 | produce the work, or an object code interpreter used to run it.
133 |
134 | The "Corresponding Source" for a work in object code form means all
135 | the source code needed to generate, install, and (for an executable
136 | work) run the object code and to modify the work, including scripts to
137 | control those activities. However, it does not include the work's
138 | System Libraries, or general-purpose tools or generally available free
139 | programs which are used unmodified in performing those activities but
140 | which are not part of the work. For example, Corresponding Source
141 | includes interface definition files associated with source files for
142 | the work, and the source code for shared libraries and dynamically
143 | linked subprograms that the work is specifically designed to require,
144 | such as by intimate data communication or control flow between those
145 | subprograms and other parts of the work.
146 |
147 | The Corresponding Source need not include anything that users
148 | can regenerate automatically from other parts of the Corresponding
149 | Source.
150 |
151 | The Corresponding Source for a work in source code form is that
152 | same work.
153 |
154 | 2. Basic Permissions.
155 |
156 | All rights granted under this License are granted for the term of
157 | copyright on the Program, and are irrevocable provided the stated
158 | conditions are met. This License explicitly affirms your unlimited
159 | permission to run the unmodified Program. The output from running a
160 | covered work is covered by this License only if the output, given its
161 | content, constitutes a covered work. This License acknowledges your
162 | rights of fair use or other equivalent, as provided by copyright law.
163 |
164 | You may make, run and propagate covered works that you do not
165 | convey, without conditions so long as your license otherwise remains
166 | in force. You may convey covered works to others for the sole purpose
167 | of having them make modifications exclusively for you, or provide you
168 | with facilities for running those works, provided that you comply with
169 | the terms of this License in conveying all material for which you do
170 | not control copyright. Those thus making or running the covered works
171 | for you must do so exclusively on your behalf, under your direction
172 | and control, on terms that prohibit them from making any copies of
173 | your copyrighted material outside their relationship with you.
174 |
175 | Conveying under any other circumstances is permitted solely under
176 | the conditions stated below. Sublicensing is not allowed; section 10
177 | makes it unnecessary.
178 |
179 | 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180 |
181 | No covered work shall be deemed part of an effective technological
182 | measure under any applicable law fulfilling obligations under article
183 | 11 of the WIPO copyright treaty adopted on 20 December 1996, or
184 | similar laws prohibiting or restricting circumvention of such
185 | measures.
186 |
187 | When you convey a covered work, you waive any legal power to forbid
188 | circumvention of technological measures to the extent such circumvention
189 | is effected by exercising rights under this License with respect to
190 | the covered work, and you disclaim any intention to limit operation or
191 | modification of the work as a means of enforcing, against the work's
192 | users, your or third parties' legal rights to forbid circumvention of
193 | technological measures.
194 |
195 | 4. Conveying Verbatim Copies.
196 |
197 | You may convey verbatim copies of the Program's source code as you
198 | receive it, in any medium, provided that you conspicuously and
199 | appropriately publish on each copy an appropriate copyright notice;
200 | keep intact all notices stating that this License and any
201 | non-permissive terms added in accord with section 7 apply to the code;
202 | keep intact all notices of the absence of any warranty; and give all
203 | recipients a copy of this License along with the Program.
204 |
205 | You may charge any price or no price for each copy that you convey,
206 | and you may offer support or warranty protection for a fee.
207 |
208 | 5. Conveying Modified Source Versions.
209 |
210 | You may convey a work based on the Program, or the modifications to
211 | produce it from the Program, in the form of source code under the
212 | terms of section 4, provided that you also meet all of these conditions:
213 |
214 | a) The work must carry prominent notices stating that you modified
215 | it, and giving a relevant date.
216 |
217 | b) The work must carry prominent notices stating that it is
218 | released under this License and any conditions added under section
219 | 7. This requirement modifies the requirement in section 4 to
220 | "keep intact all notices".
221 |
222 | c) You must license the entire work, as a whole, under this
223 | License to anyone who comes into possession of a copy. This
224 | License will therefore apply, along with any applicable section 7
225 | additional terms, to the whole of the work, and all its parts,
226 | regardless of how they are packaged. This License gives no
227 | permission to license the work in any other way, but it does not
228 | invalidate such permission if you have separately received it.
229 |
230 | d) If the work has interactive user interfaces, each must display
231 | Appropriate Legal Notices; however, if the Program has interactive
232 | interfaces that do not display Appropriate Legal Notices, your
233 | work need not make them do so.
234 |
235 | A compilation of a covered work with other separate and independent
236 | works, which are not by their nature extensions of the covered work,
237 | and which are not combined with it such as to form a larger program,
238 | in or on a volume of a storage or distribution medium, is called an
239 | "aggregate" if the compilation and its resulting copyright are not
240 | used to limit the access or legal rights of the compilation's users
241 | beyond what the individual works permit. Inclusion of a covered work
242 | in an aggregate does not cause this License to apply to the other
243 | parts of the aggregate.
244 |
245 | 6. Conveying Non-Source Forms.
246 |
247 | You may convey a covered work in object code form under the terms
248 | of sections 4 and 5, provided that you also convey the
249 | machine-readable Corresponding Source under the terms of this License,
250 | in one of these ways:
251 |
252 | a) Convey the object code in, or embodied in, a physical product
253 | (including a physical distribution medium), accompanied by the
254 | Corresponding Source fixed on a durable physical medium
255 | customarily used for software interchange.
256 |
257 | b) Convey the object code in, or embodied in, a physical product
258 | (including a physical distribution medium), accompanied by a
259 | written offer, valid for at least three years and valid for as
260 | long as you offer spare parts or customer support for that product
261 | model, to give anyone who possesses the object code either (1) a
262 | copy of the Corresponding Source for all the software in the
263 | product that is covered by this License, on a durable physical
264 | medium customarily used for software interchange, for a price no
265 | more than your reasonable cost of physically performing this
266 | conveying of source, or (2) access to copy the
267 | Corresponding Source from a network server at no charge.
268 |
269 | c) Convey individual copies of the object code with a copy of the
270 | written offer to provide the Corresponding Source. This
271 | alternative is allowed only occasionally and noncommercially, and
272 | only if you received the object code with such an offer, in accord
273 | with subsection 6b.
274 |
275 | d) Convey the object code by offering access from a designated
276 | place (gratis or for a charge), and offer equivalent access to the
277 | Corresponding Source in the same way through the same place at no
278 | further charge. You need not require recipients to copy the
279 | Corresponding Source along with the object code. If the place to
280 | copy the object code is a network server, the Corresponding Source
281 | may be on a different server (operated by you or a third party)
282 | that supports equivalent copying facilities, provided you maintain
283 | clear directions next to the object code saying where to find the
284 | Corresponding Source. Regardless of what server hosts the
285 | Corresponding Source, you remain obligated to ensure that it is
286 | available for as long as needed to satisfy these requirements.
287 |
288 | e) Convey the object code using peer-to-peer transmission, provided
289 | you inform other peers where the object code and Corresponding
290 | Source of the work are being offered to the general public at no
291 | charge under subsection 6d.
292 |
293 | A separable portion of the object code, whose source code is excluded
294 | from the Corresponding Source as a System Library, need not be
295 | included in conveying the object code work.
296 |
297 | A "User Product" is either (1) a "consumer product", which means any
298 | tangible personal property which is normally used for personal, family,
299 | or household purposes, or (2) anything designed or sold for incorporation
300 | into a dwelling. In determining whether a product is a consumer product,
301 | doubtful cases shall be resolved in favor of coverage. For a particular
302 | product received by a particular user, "normally used" refers to a
303 | typical or common use of that class of product, regardless of the status
304 | of the particular user or of the way in which the particular user
305 | actually uses, or expects or is expected to use, the product. A product
306 | is a consumer product regardless of whether the product has substantial
307 | commercial, industrial or non-consumer uses, unless such uses represent
308 | the only significant mode of use of the product.
309 |
310 | "Installation Information" for a User Product means any methods,
311 | procedures, authorization keys, or other information required to install
312 | and execute modified versions of a covered work in that User Product from
313 | a modified version of its Corresponding Source. The information must
314 | suffice to ensure that the continued functioning of the modified object
315 | code is in no case prevented or interfered with solely because
316 | modification has been made.
317 |
318 | If you convey an object code work under this section in, or with, or
319 | specifically for use in, a User Product, and the conveying occurs as
320 | part of a transaction in which the right of possession and use of the
321 | User Product is transferred to the recipient in perpetuity or for a
322 | fixed term (regardless of how the transaction is characterized), the
323 | Corresponding Source conveyed under this section must be accompanied
324 | by the Installation Information. But this requirement does not apply
325 | if neither you nor any third party retains the ability to install
326 | modified object code on the User Product (for example, the work has
327 | been installed in ROM).
328 |
329 | The requirement to provide Installation Information does not include a
330 | requirement to continue to provide support service, warranty, or updates
331 | for a work that has been modified or installed by the recipient, or for
332 | the User Product in which it has been modified or installed. Access to a
333 | network may be denied when the modification itself materially and
334 | adversely affects the operation of the network or violates the rules and
335 | protocols for communication across the network.
336 |
337 | Corresponding Source conveyed, and Installation Information provided,
338 | in accord with this section must be in a format that is publicly
339 | documented (and with an implementation available to the public in
340 | source code form), and must require no special password or key for
341 | unpacking, reading or copying.
342 |
343 | 7. Additional Terms.
344 |
345 | "Additional permissions" are terms that supplement the terms of this
346 | License by making exceptions from one or more of its conditions.
347 | Additional permissions that are applicable to the entire Program shall
348 | be treated as though they were included in this License, to the extent
349 | that they are valid under applicable law. If additional permissions
350 | apply only to part of the Program, that part may be used separately
351 | under those permissions, but the entire Program remains governed by
352 | this License without regard to the additional permissions.
353 |
354 | When you convey a copy of a covered work, you may at your option
355 | remove any additional permissions from that copy, or from any part of
356 | it. (Additional permissions may be written to require their own
357 | removal in certain cases when you modify the work.) You may place
358 | additional permissions on material, added by you to a covered work,
359 | for which you have or can give appropriate copyright permission.
360 |
361 | Notwithstanding any other provision of this License, for material you
362 | add to a covered work, you may (if authorized by the copyright holders of
363 | that material) supplement the terms of this License with terms:
364 |
365 | a) Disclaiming warranty or limiting liability differently from the
366 | terms of sections 15 and 16 of this License; or
367 |
368 | b) Requiring preservation of specified reasonable legal notices or
369 | author attributions in that material or in the Appropriate Legal
370 | Notices displayed by works containing it; or
371 |
372 | c) Prohibiting misrepresentation of the origin of that material, or
373 | requiring that modified versions of such material be marked in
374 | reasonable ways as different from the original version; or
375 |
376 | d) Limiting the use for publicity purposes of names of licensors or
377 | authors of the material; or
378 |
379 | e) Declining to grant rights under trademark law for use of some
380 | trade names, trademarks, or service marks; or
381 |
382 | f) Requiring indemnification of licensors and authors of that
383 | material by anyone who conveys the material (or modified versions of
384 | it) with contractual assumptions of liability to the recipient, for
385 | any liability that these contractual assumptions directly impose on
386 | those licensors and authors.
387 |
388 | All other non-permissive additional terms are considered "further
389 | restrictions" within the meaning of section 10. If the Program as you
390 | received it, or any part of it, contains a notice stating that it is
391 | governed by this License along with a term that is a further
392 | restriction, you may remove that term. If a license document contains
393 | a further restriction but permits relicensing or conveying under this
394 | License, you may add to a covered work material governed by the terms
395 | of that license document, provided that the further restriction does
396 | not survive such relicensing or conveying.
397 |
398 | If you add terms to a covered work in accord with this section, you
399 | must place, in the relevant source files, a statement of the
400 | additional terms that apply to those files, or a notice indicating
401 | where to find the applicable terms.
402 |
403 | Additional terms, permissive or non-permissive, may be stated in the
404 | form of a separately written license, or stated as exceptions;
405 | the above requirements apply either way.
406 |
407 | 8. Termination.
408 |
409 | You may not propagate or modify a covered work except as expressly
410 | provided under this License. Any attempt otherwise to propagate or
411 | modify it is void, and will automatically terminate your rights under
412 | this License (including any patent licenses granted under the third
413 | paragraph of section 11).
414 |
415 | However, if you cease all violation of this License, then your
416 | license from a particular copyright holder is reinstated (a)
417 | provisionally, unless and until the copyright holder explicitly and
418 | finally terminates your license, and (b) permanently, if the copyright
419 | holder fails to notify you of the violation by some reasonable means
420 | prior to 60 days after the cessation.
421 |
422 | Moreover, your license from a particular copyright holder is
423 | reinstated permanently if the copyright holder notifies you of the
424 | violation by some reasonable means, this is the first time you have
425 | received notice of violation of this License (for any work) from that
426 | copyright holder, and you cure the violation prior to 30 days after
427 | your receipt of the notice.
428 |
429 | Termination of your rights under this section does not terminate the
430 | licenses of parties who have received copies or rights from you under
431 | this License. If your rights have been terminated and not permanently
432 | reinstated, you do not qualify to receive new licenses for the same
433 | material under section 10.
434 |
435 | 9. Acceptance Not Required for Having Copies.
436 |
437 | You are not required to accept this License in order to receive or
438 | run a copy of the Program. Ancillary propagation of a covered work
439 | occurring solely as a consequence of using peer-to-peer transmission
440 | to receive a copy likewise does not require acceptance. However,
441 | nothing other than this License grants you permission to propagate or
442 | modify any covered work. These actions infringe copyright if you do
443 | not accept this License. Therefore, by modifying or propagating a
444 | covered work, you indicate your acceptance of this License to do so.
445 |
446 | 10. Automatic Licensing of Downstream Recipients.
447 |
448 | Each time you convey a covered work, the recipient automatically
449 | receives a license from the original licensors, to run, modify and
450 | propagate that work, subject to this License. You are not responsible
451 | for enforcing compliance by third parties with this License.
452 |
453 | An "entity transaction" is a transaction transferring control of an
454 | organization, or substantially all assets of one, or subdividing an
455 | organization, or merging organizations. If propagation of a covered
456 | work results from an entity transaction, each party to that
457 | transaction who receives a copy of the work also receives whatever
458 | licenses to the work the party's predecessor in interest had or could
459 | give under the previous paragraph, plus a right to possession of the
460 | Corresponding Source of the work from the predecessor in interest, if
461 | the predecessor has it or can get it with reasonable efforts.
462 |
463 | You may not impose any further restrictions on the exercise of the
464 | rights granted or affirmed under this License. For example, you may
465 | not impose a license fee, royalty, or other charge for exercise of
466 | rights granted under this License, and you may not initiate litigation
467 | (including a cross-claim or counterclaim in a lawsuit) alleging that
468 | any patent claim is infringed by making, using, selling, offering for
469 | sale, or importing the Program or any portion of it.
470 |
471 | 11. Patents.
472 |
473 | A "contributor" is a copyright holder who authorizes use under this
474 | License of the Program or a work on which the Program is based. The
475 | work thus licensed is called the contributor's "contributor version".
476 |
477 | A contributor's "essential patent claims" are all patent claims
478 | owned or controlled by the contributor, whether already acquired or
479 | hereafter acquired, that would be infringed by some manner, permitted
480 | by this License, of making, using, or selling its contributor version,
481 | but do not include claims that would be infringed only as a
482 | consequence of further modification of the contributor version. For
483 | purposes of this definition, "control" includes the right to grant
484 | patent sublicenses in a manner consistent with the requirements of
485 | this License.
486 |
487 | Each contributor grants you a non-exclusive, worldwide, royalty-free
488 | patent license under the contributor's essential patent claims, to
489 | make, use, sell, offer for sale, import and otherwise run, modify and
490 | propagate the contents of its contributor version.
491 |
492 | In the following three paragraphs, a "patent license" is any express
493 | agreement or commitment, however denominated, not to enforce a patent
494 | (such as an express permission to practice a patent or covenant not to
495 | sue for patent infringement). To "grant" such a patent license to a
496 | party means to make such an agreement or commitment not to enforce a
497 | patent against the party.
498 |
499 | If you convey a covered work, knowingly relying on a patent license,
500 | and the Corresponding Source of the work is not available for anyone
501 | to copy, free of charge and under the terms of this License, through a
502 | publicly available network server or other readily accessible means,
503 | then you must either (1) cause the Corresponding Source to be so
504 | available, or (2) arrange to deprive yourself of the benefit of the
505 | patent license for this particular work, or (3) arrange, in a manner
506 | consistent with the requirements of this License, to extend the patent
507 | license to downstream recipients. "Knowingly relying" means you have
508 | actual knowledge that, but for the patent license, your conveying the
509 | covered work in a country, or your recipient's use of the covered work
510 | in a country, would infringe one or more identifiable patents in that
511 | country that you have reason to believe are valid.
512 |
513 | If, pursuant to or in connection with a single transaction or
514 | arrangement, you convey, or propagate by procuring conveyance of, a
515 | covered work, and grant a patent license to some of the parties
516 | receiving the covered work authorizing them to use, propagate, modify
517 | or convey a specific copy of the covered work, then the patent license
518 | you grant is automatically extended to all recipients of the covered
519 | work and works based on it.
520 |
521 | A patent license is "discriminatory" if it does not include within
522 | the scope of its coverage, prohibits the exercise of, or is
523 | conditioned on the non-exercise of one or more of the rights that are
524 | specifically granted under this License. You may not convey a covered
525 | work if you are a party to an arrangement with a third party that is
526 | in the business of distributing software, under which you make payment
527 | to the third party based on the extent of your activity of conveying
528 | the work, and under which the third party grants, to any of the
529 | parties who would receive the covered work from you, a discriminatory
530 | patent license (a) in connection with copies of the covered work
531 | conveyed by you (or copies made from those copies), or (b) primarily
532 | for and in connection with specific products or compilations that
533 | contain the covered work, unless you entered into that arrangement,
534 | or that patent license was granted, prior to 28 March 2007.
535 |
536 | Nothing in this License shall be construed as excluding or limiting
537 | any implied license or other defenses to infringement that may
538 | otherwise be available to you under applicable patent law.
539 |
540 | 12. No Surrender of Others' Freedom.
541 |
542 | If conditions are imposed on you (whether by court order, agreement or
543 | otherwise) that contradict the conditions of this License, they do not
544 | excuse you from the conditions of this License. If you cannot convey a
545 | covered work so as to satisfy simultaneously your obligations under this
546 | License and any other pertinent obligations, then as a consequence you may
547 | not convey it at all. For example, if you agree to terms that obligate you
548 | to collect a royalty for further conveying from those to whom you convey
549 | the Program, the only way you could satisfy both those terms and this
550 | License would be to refrain entirely from conveying the Program.
551 |
552 | 13. Use with the GNU Affero General Public License.
553 |
554 | Notwithstanding any other provision of this License, you have
555 | permission to link or combine any covered work with a work licensed
556 | under version 3 of the GNU Affero General Public License into a single
557 | combined work, and to convey the resulting work. The terms of this
558 | License will continue to apply to the part which is the covered work,
559 | but the special requirements of the GNU Affero General Public License,
560 | section 13, concerning interaction through a network will apply to the
561 | combination as such.
562 |
563 | 14. Revised Versions of this License.
564 |
565 | The Free Software Foundation may publish revised and/or new versions of
566 | the GNU General Public License from time to time. Such new versions will
567 | be similar in spirit to the present version, but may differ in detail to
568 | address new problems or concerns.
569 |
570 | Each version is given a distinguishing version number. If the
571 | Program specifies that a certain numbered version of the GNU General
572 | Public License "or any later version" applies to it, you have the
573 | option of following the terms and conditions either of that numbered
574 | version or of any later version published by the Free Software
575 | Foundation. If the Program does not specify a version number of the
576 | GNU General Public License, you may choose any version ever published
577 | by the Free Software Foundation.
578 |
579 | If the Program specifies that a proxy can decide which future
580 | versions of the GNU General Public License can be used, that proxy's
581 | public statement of acceptance of a version permanently authorizes you
582 | to choose that version for the Program.
583 |
584 | Later license versions may give you additional or different
585 | permissions. However, no additional obligations are imposed on any
586 | author or copyright holder as a result of your choosing to follow a
587 | later version.
588 |
589 | 15. Disclaimer of Warranty.
590 |
591 | THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592 | APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593 | HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594 | OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595 | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596 | PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597 | IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598 | ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599 |
600 | 16. Limitation of Liability.
601 |
602 | IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604 | THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605 | GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606 | USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607 | DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608 | PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609 | EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610 | SUCH DAMAGES.
611 |
612 | 17. Interpretation of Sections 15 and 16.
613 |
614 | If the disclaimer of warranty and limitation of liability provided
615 | above cannot be given local legal effect according to their terms,
616 | reviewing courts shall apply local law that most closely approximates
617 | an absolute waiver of all civil liability in connection with the
618 | Program, unless a warranty or assumption of liability accompanies a
619 | copy of the Program in return for a fee.
620 |
621 | END OF TERMS AND CONDITIONS
622 |
623 | How to Apply These Terms to Your New Programs
624 |
625 | If you develop a new program, and you want it to be of the greatest
626 | possible use to the public, the best way to achieve this is to make it
627 | free software which everyone can redistribute and change under these terms.
628 |
629 | To do so, attach the following notices to the program. It is safest
630 | to attach them to the start of each source file to most effectively
631 | state the exclusion of warranty; and each file should have at least
632 | the "copyright" line and a pointer to where the full notice is found.
633 |
634 |
635 | Copyright (C)
636 |
637 | This program is free software: you can redistribute it and/or modify
638 | it under the terms of the GNU General Public License as published by
639 | the Free Software Foundation, either version 3 of the License, or
640 | (at your option) any later version.
641 |
642 | This program is distributed in the hope that it will be useful,
643 | but WITHOUT ANY WARRANTY; without even the implied warranty of
644 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
645 | GNU General Public License for more details.
646 |
647 | You should have received a copy of the GNU General Public License
648 | along with this program. If not, see .
649 |
650 | Also add information on how to contact you by electronic and paper mail.
651 |
652 | If the program does terminal interaction, make it output a short
653 | notice like this when it starts in an interactive mode:
654 |
655 | Copyright (C)
656 | This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657 | This is free software, and you are welcome to redistribute it
658 | under certain conditions; type `show c' for details.
659 |
660 | The hypothetical commands `show w' and `show c' should show the appropriate
661 | parts of the General Public License. Of course, your program's commands
662 | might be different; for a GUI interface, you would use an "about box".
663 |
664 | You should also get your employer (if you work as a programmer) or school,
665 | if any, to sign a "copyright disclaimer" for the program, if necessary.
666 | For more information on this, and how to apply and follow the GNU GPL, see
667 | .
668 |
669 | The GNU General Public License does not permit incorporating your program
670 | into proprietary programs. If your program is a subroutine library, you
671 | may consider it more useful to permit linking proprietary applications with
672 | the library. If this is what you want to do, use the GNU Lesser General
673 | Public License instead of this License. But first, please read
674 | .
675 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # k8s-debugbox
2 |
3 | k8s-debugbox is a tool for debugging Kubernetes pods based on minimal images.
4 | It works by copying statically linked tools, including a shell, into the pods you want to debug.
5 |
6 | ## Requirements
7 |
8 | Kubernetes cluster:
9 | * k8s-debugbox has no special requirements towards Kubernetes clusters
10 |
11 | Client:
12 | * Bash 3 or later
13 | * [kubectl (Kubernetes client)](https://kubernetes.io/docs/tasks/tools/install-kubectl/) or [oc (OpenShift client)](https://docs.okd.io/latest/cli_reference/get_started_cli.html)
14 |
15 | Most modern operating systems already come with Bash 3 or later. However on Windows you have to get it by either installing the full version of [Cmdr](http://cmder.net/) or [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10) (Windows 10 only).
16 |
17 | ## Installation
18 |
19 | 1. Download a [k8s-debugbox release](https://github.com/puzzle/k8s-debugbox/releases)
20 | 2. Extract the downloaded file
21 | 3. Change into the created directory
22 | 4. Run `install.sh` (`install.bat` on Windows)
23 |
24 | ## Usage
25 |
26 | ```sh
27 | $ k8s-debugbox --help
28 | Debug pods based on minimal images.
29 |
30 | Examples:
31 | # Open debugging shell for the first container of the specified pod,
32 | # install debugging tools into the container if they aren't installed yet.
33 | k8s-debugbox pod hello-42-dmj88
34 |
35 | # Open debugging shell for container 'proxy' of the specified pod,
36 | # install debugging tools into the container if they aren't installed yet.
37 | k8s-debugbox pod hello-42-dmj88 -c proxy
38 |
39 | # Install debugging tools into specified pod.
40 | k8s-debugbox pod hello-42-dmj88 --add
41 |
42 | # Uninstall debugging tools from specified pod.
43 | k8s-debugbox pod hello-42-dmj88 --remove
44 |
45 | # Open debugging shell for the first container of the first pod of the specified controller,
46 | # install debugging tools into all containers of the controller if they aren't installed yet.
47 | # Requires a redeployment.
48 | k8s-debugbox deployment hello
49 |
50 | # Open debugging shell for the first container of the first pod of the specified controller,
51 | # install debugging tools into all containers of the controller if they aren't installed yet.
52 | # Uses the specified Docker image for tool installation instead of the default one.
53 | # Requires a redeployment.
54 | k8s-debugbox deployment hello -i example.org/tools/k8s-debugbox
55 |
56 | # Uninstall debugging tools from specified controller.
57 | # Requires a redeployment.
58 | k8s-debugbox deployment hello --remove
59 |
60 | Options:
61 | -n, --namespace='': Namespace which contains the pod to debug, defaults to the namespace of the current kubectl context
62 | -c, --container='': Container name to open shell for, defaults to first container in pod
63 | -i, --image='puzzle/k8s-debugbox': Docker image for installation of debugging via controller. Must be built from 'puzzle/k8s-debugbox' repository.
64 | -h, --help: Show this help message
65 | --add: Install debugging tools into specified resource
66 | --remove: Remove debugging tools from specified resource
67 |
68 | Usage:
69 | k8s-debugbox TYPE NAME [options]
70 | ```
71 |
72 | A redeployment is necessary if you install the debugging tools into a controller (e.g. Deployment, DeploymentConfig, CronJob, StatefulSet, DaemonSet), which is triggered automatically unless disabled (triggering can only be disabled in OpenShift DeploymentConfigs).
73 |
74 | ## Developing
75 |
76 | To start developing on k8s-debugbox itself you just have to clone the [k8s-debugbox repository](https://github.com/puzzle/k8s-debugbox), enter the created directory and run the `bootstrap.sh` script, which will download the statically compiled debugging tools using curl.
77 |
--------------------------------------------------------------------------------
/bin/k8s-debugbox:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 |
3 | debugbox_dir=${HOME}/.k8s-debugbox/box
4 | pod_debugbox_dir=/tmp/box # Use // to prevent MSYS path translation
5 |
6 | usage() {
7 | error="$1"
8 |
9 | message=(
10 | "Debug pods based on minimal images."
11 | ""
12 | "Examples:"
13 | " # Open debugging shell for the first container of the specified pod,"
14 | " # install debugging tools into the container if they aren't installed yet."
15 | " k8s-debugbox pod hello-42-dmj88"
16 | ""
17 | " # Open debugging shell for container 'proxy' of the specified pod,"
18 | " # install debugging tools into the container if they aren't installed yet."
19 | " k8s-debugbox pod hello-42-dmj88 -c proxy"
20 | ""
21 | " # Install debugging tools into specified pod."
22 | " k8s-debugbox pod hello-42-dmj88 --add"
23 | ""
24 | " # Uninstall debugging tools from specified pod."
25 | " k8s-debugbox pod hello-42-dmj88 --remove"
26 | ""
27 | " # Open debugging shell for the first container of the first pod of the specified controller,"
28 | " # install debugging tools into all containers of the controller if they aren't installed yet."
29 | " # Requires a redeployment."
30 | " k8s-debugbox deployment hello"
31 | ""
32 | " # Open debugging shell for the first container of the first pod of the specified controller,"
33 | " # install debugging tools into all containers of the controller if they aren't installed yet."
34 | " # Uses the specified Docker image for tool installation instead of the default one."
35 | " # Requires a redeployment."
36 | " k8s-debugbox deployment hello -i example.org/tools/k8s-debugbox"
37 | ""
38 | " # Uninstall debugging tools from specified controller."
39 | " # Requires a redeployment."
40 | " k8s-debugbox deployment hello --remove"
41 | ""
42 | "Options:"
43 | " -n, --namespace='': Namespace which contains the pod to debug, defaults to the namespace of the current kubectl context"
44 | " -c, --container='': Container name to open shell for, defaults to first container in pod"
45 | " -i, --image='puzzle/k8s-debugbox': Docker image for installation of debugging via controller. Must be built from 'puzzle/k8s-debugbox' repository."
46 | " -h, --help: Show this help message"
47 | " --add: Install debugging tools into specified resource"
48 | " --remove: Remove debugging tools from specified resource"
49 | ""
50 | "Usage:"
51 | " $(basename $0) TYPE NAME [options]"
52 |
53 | )
54 | printf '%s\n' "${message[@]}"
55 |
56 | if [ "$error" ]; then
57 | echo
58 | echo "$error" >&2
59 | exit 1
60 | else
61 | exit 0
62 | fi
63 | }
64 |
65 | init() {
66 | if command -v oc >/dev/null 2>&1; then
67 | kubectl=oc
68 | elif command -v kubectl >/dev/null 2>&1; then
69 | kubectl=kubectl
70 | else
71 | echo "$0: Either the Kubernetes client 'kubectl' or the OpenShift client 'oc' is required!" >&2
72 | exit 1
73 | fi
74 | }
75 |
76 | parse_cmdline() {
77 | local args=()
78 | add_opt=false
79 | remove_opt=false
80 | container_opt=""
81 | image_opt="puzzle/k8s-debugbox"
82 | namespace_opt=""
83 | while [ $# -gt 0 ]; do
84 | case "$1" in
85 | -h|--help)
86 | usage
87 | ;;
88 | --add)
89 | add_opt=true
90 | ;;
91 | --remove)
92 | remove_opt=true
93 | ;;
94 | -c|--container)
95 | shift
96 | container_opt="--container=${1}"
97 | ;;
98 | --container=*)
99 | container_opt="--container=${1#*=}"
100 | ;;
101 | -i|--image)
102 | shift
103 | image_opt="${1}"
104 | ;;
105 | --image=*)
106 | image_opt="${1#*=}"
107 | ;;
108 | -n|--namespace)
109 | shift
110 | namespace_opt="--namespace=${1}"
111 | ;;
112 | --namespace=*)
113 | namespace_opt="--namespace=${1#*=}"
114 | ;;
115 | -*)
116 | usage "Unknown option $1"
117 | ;;
118 | *)
119 | args+=("$1")
120 | esac
121 | shift
122 | done
123 |
124 | if [ ${#args[@]} -ne 2 ]; then
125 | usage "Invalid number of arguments!"
126 | fi
127 |
128 | type_arg="${args[0]}"
129 | name_arg="${args[1]}"
130 | }
131 |
132 | install_into_pod() {
133 | if ! ${kubectl} exec ${namespace_opt} ${container_opt} "${name_arg}" -- ${pod_debugbox_dir}/bin/true >/dev/null 2>&1; then
134 | echo "Uploading debugging tools into ${type_arg} ${name_arg}"
135 | ${kubectl} cp ${namespace_opt} ${container_opt} ${debugbox_dir} "${name_arg}":/tmp/
136 | if [ $? != 0 ]; then
137 | echo >&2
138 | echo "Couldn't upload debugging tools!" >&2
139 | echo "Instead you can patch the controller (deployment, deploymentconfig, daemonset, ...) to use an init container with debugging tools, this requires a new deployment though!" >&2
140 | exit 1
141 | fi
142 |
143 | ${kubectl} exec ${namespace_opt} ${container_opt} "${name_arg}" -- ${pod_debugbox_dir}/install-k8s-debugbox.sh || exit 1
144 | fi
145 |
146 | if [ "${add_opt}" != true ]; then
147 | ${kubectl} exec ${namespace_opt} ${container_opt} -it "${name_arg}" -- ${pod_debugbox_dir}/sh
148 | fi
149 | }
150 |
151 | remove_from_pod() {
152 | if ${kubectl} exec ${namespace_opt} "${name_arg}" -- ${pod_debugbox_dir}/bin/test -e ${pod_debugbox_dir}/uninstall-k8s-debugbox.sh >/dev/null 2>&1; then
153 | echo "Removing debugging tools from ${type_arg} ${name_arg}"
154 | ${kubectl} exec ${namespace_opt} ${container_opt} "${name_arg}" -- ${pod_debugbox_dir}/uninstall-k8s-debugbox.sh || exit 1
155 | else
156 | echo "No debugging tools are installed in ${type_arg} '${name_arg}' with 'kubectl cp' mechanism!"
157 | fi
158 | }
159 |
160 | install_into_controller() {
161 | echo "Installing debugging tools into ${type_arg} ${name_arg}"
162 | containers=$(${kubectl} get ${namespace_opt} "${type_arg}" "${name_arg}" -o jsonpath='{.spec.template.spec.containers[*].name}')
163 |
164 | annotations=($(${kubectl} get ${namespace_opt} "${type_arg}" "${name_arg}" -o go-template='{{range $key, $value := .spec.template.metadata.annotations}}{{$key}}{{"\n"}}{{end}}'))
165 | if [[ " ${annotations[@]} " =~ " pod.alpha.kubernetes.io/init-containers " ]]; then
166 | alpha_init_containers_annotation=true
167 | fi
168 | if [[ " ${annotations[@]} " =~ " pod.beta.kubernetes.io/init-containers " ]]; then
169 | beta_init_containers_annotation=true
170 | fi
171 |
172 | patch=(
173 | "spec:"
174 | " template:"
175 | )
176 |
177 | if [ "${alpha_init_containers_annotation}" = true ] || [ "${beta_init_containers_annotation}" = true ]; then
178 | patch+=(
179 | " metadata:"
180 | " annotations: "
181 | )
182 | if [ "${alpha_init_containers_annotation}" = true ]; then
183 | patch+=(
184 | " pod.alpha.kubernetes.io/init-containers: null"
185 | )
186 | fi
187 | if [ "${beta_init_containers_annotation}" = true ]; then
188 | patch+=(
189 | " pod.beta.kubernetes.io/init-containers: null"
190 | )
191 | fi
192 | fi
193 |
194 | patch+=(
195 | " spec:"
196 | " volumes:"
197 | " - name: k8s-debugbox"
198 | " emptyDir: {}"
199 | " initContainers:"
200 | " - name: k8s-debugbox"
201 | " image: ${image_opt}"
202 | " imagePullPolicy: Always"
203 | " volumeMounts:"
204 | " - name: k8s-debugbox"
205 | " mountPath: ${pod_debugbox_dir}"
206 | " containers:"
207 | )
208 |
209 | for container in ${containers}; do
210 | patch+=(
211 | " - name: ${container}"
212 | " volumeMounts:"
213 | " - name: k8s-debugbox"
214 | " mountPath: ${pod_debugbox_dir}"
215 | )
216 | done
217 |
218 | patch="$(printf '%s\n' "${patch[@]}")" # convert patch to string
219 | ${kubectl} patch ${namespace_opt} --patch="${patch}" "${type_arg}" "${name_arg}"
220 | ${kubectl} rollout status ${namespace_opt} "${type_arg}" "${name_arg}"
221 |
222 | if [ "${add_opt}" != true ]; then
223 | selector=$(${kubectl} get ${namespace_opt} "${type_arg}" "${name_arg}" -o go-template='{{range $key, $value := (or .spec.selector.matchLabels .spec.selector)}}{{$key}}={{$value}},{{end}}')
224 | selector="${selector%,}" # remove trailing comma
225 | pods=($(${kubectl} get pod ${namespace_opt} -l "${selector}" -o go-template='{{range .items}}{{if not .metadata.deletionTimestamp}}{{.metadata.name}}{{"\n"}}{{end}}{{end}}'))
226 | ${kubectl} exec ${namespace_opt} ${container_opt} -it ${pods[0]} -- ${pod_debugbox_dir}/sh
227 | fi
228 | }
229 |
230 | remove_from_controller() {
231 | installed=$(${kubectl} get ${namespace_opt} ${type_arg} ${name_arg} -o jsonpath='{.spec.template.spec.volumes[?(@.name=="k8s-debugbox")].name}')
232 | if [ ! "${installed}" ]; then
233 | echo "No debugging tools installed in ${type_arg} ${name_arg}"
234 | exit 0
235 | fi
236 |
237 | echo "Removing debugging tools from ${type_arg} ${name_arg}"
238 | containers=$(${kubectl} get ${namespace_opt} ${type_arg} ${name_arg} -o jsonpath='{.spec.template.spec.containers[*].name}')
239 |
240 | patch=(
241 | "spec:"
242 | " template:"
243 | " metadata:"
244 | " annotations:"
245 | " pod.alpha.kubernetes.io/init-containers: null"
246 | " pod.beta.kubernetes.io/init-containers: null"
247 | " spec:"
248 | " volumes:"
249 | " - \$patch: delete"
250 | " name: k8s-debugbox"
251 | " initContainers:"
252 | " - \$patch: delete"
253 | " name: k8s-debugbox"
254 | " containers:"
255 | )
256 |
257 | for container in ${containers}; do
258 | patch+=(
259 | " - name: ${container}"
260 | " volumeMounts:"
261 | " - \$patch: delete"
262 | " mountPath: ${pod_debugbox_dir}"
263 | )
264 | done
265 |
266 |
267 | patch="$(printf '%s\n' "${patch[@]}")" # convert patch to string
268 | ${kubectl} patch ${namespace_opt} --patch="${patch}" ${type_arg} ${name_arg} || exit 1 #&& \
269 | ${kubectl} rollout status ${namespace_opt} "${type_arg}" "${name_arg}" || exit 1
270 | }
271 |
272 | init
273 | parse_cmdline "$@"
274 |
275 | if [ "${type_arg}" = "pod" ]; then
276 | if [ "${remove_opt}" != true ]; then
277 | install_into_pod
278 | else
279 | remove_from_pod
280 | fi
281 | else
282 | if [ "${remove_opt}" != true ]; then
283 | install_into_controller
284 | else
285 | remove_from_controller
286 | fi
287 | fi
288 |
--------------------------------------------------------------------------------
/bin/k8s-debugbox.bat:
--------------------------------------------------------------------------------
1 | @echo off
2 |
3 | rem Use sh instead of bash to prevent calling Windows Subsystem for Linux bash, which comes first in PATH.
4 | sh %~dp0\k8s-debugbox %*
5 |
--------------------------------------------------------------------------------
/bootstrap.sh:
--------------------------------------------------------------------------------
1 | #!/bin/sh
2 |
3 | if [ ! -e bin/k8s-debugbox ]; then
4 | echo "'$(basename "$0")' must be run in 'k8s-debugbox' directory!" >&2
5 | exit 1
6 | fi
7 |
8 | echo "Downloading static busybox binary:"
9 | curl -Lo box/busybox https://busybox.net/downloads/binaries/1.28.1-defconfig-multiarch/busybox-x86_64
10 | chmod +x box/busybox
11 |
12 | echo
13 | echo "Downloading static toybox binary:"
14 | curl -Lo box/toybox http://landley.net/toybox/bin/toybox-x86_64
15 | chmod +x box/toybox
16 |
17 | echo
18 | echo "Downloading static curl binary and CA bundle:"
19 | curl -Lo box/curl https://github.com/dtschan/curl-static/releases/download/v7.63.0/curl
20 | curl -Lo box/cacert.pem https://curl.haxx.se/ca/cacert.pem
21 | chmod +x box/curl
22 |
23 | echo
24 | echo "Downloading static vim binary:"
25 | curl -Lo box/vim https://github.com/dtschan/vim-static/releases/download/v8.1.1045/vim
26 | chmod +x box/vim
27 |
28 | echo ""
29 | echo "Downloading terminfo database."
30 | terminfo_url="http://dl-cdn.alpinelinux.org/alpine/latest-stable/main/x86_64/"
31 | terminfo_url="${terminfo_url}$(curl -s ${terminfo_url} | sed -ne 's/.*href=\"\(ncurses-terminfo-base-[^\"]\+\)\".*/\1/p')"
32 | curl -Lo box/terminfo.apk ${terminfo_url}
33 | tar -C box -zxf box/terminfo.apk etc/terminfo 2>/dev/null
34 | rm -f box/terminfo.apk
35 |
--------------------------------------------------------------------------------
/box/busybox.LICENSE:
--------------------------------------------------------------------------------
1 | --- A note on GPL versions
2 |
3 | BusyBox is distributed under version 2 of the General Public License (included
4 | in its entirety, below). Version 2 is the only version of this license which
5 | this version of BusyBox (or modified versions derived from this one) may be
6 | distributed under.
7 |
8 | ------------------------------------------------------------------------
9 | GNU GENERAL PUBLIC LICENSE
10 | Version 2, June 1991
11 |
12 | Copyright (C) 1989, 1991 Free Software Foundation, Inc.
13 | 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
14 | Everyone is permitted to copy and distribute verbatim copies
15 | of this license document, but changing it is not allowed.
16 |
17 | Preamble
18 |
19 | The licenses for most software are designed to take away your
20 | freedom to share and change it. By contrast, the GNU General Public
21 | License is intended to guarantee your freedom to share and change free
22 | software--to make sure the software is free for all its users. This
23 | General Public License applies to most of the Free Software
24 | Foundation's software and to any other program whose authors commit to
25 | using it. (Some other Free Software Foundation software is covered by
26 | the GNU Library General Public License instead.) You can apply it to
27 | your programs, too.
28 |
29 | When we speak of free software, we are referring to freedom, not
30 | price. Our General Public Licenses are designed to make sure that you
31 | have the freedom to distribute copies of free software (and charge for
32 | this service if you wish), that you receive source code or can get it
33 | if you want it, that you can change the software or use pieces of it
34 | in new free programs; and that you know you can do these things.
35 |
36 | To protect your rights, we need to make restrictions that forbid
37 | anyone to deny you these rights or to ask you to surrender the rights.
38 | These restrictions translate to certain responsibilities for you if you
39 | distribute copies of the software, or if you modify it.
40 |
41 | For example, if you distribute copies of such a program, whether
42 | gratis or for a fee, you must give the recipients all the rights that
43 | you have. You must make sure that they, too, receive or can get the
44 | source code. And you must show them these terms so they know their
45 | rights.
46 |
47 | We protect your rights with two steps: (1) copyright the software, and
48 | (2) offer you this license which gives you legal permission to copy,
49 | distribute and/or modify the software.
50 |
51 | Also, for each author's protection and ours, we want to make certain
52 | that everyone understands that there is no warranty for this free
53 | software. If the software is modified by someone else and passed on, we
54 | want its recipients to know that what they have is not the original, so
55 | that any problems introduced by others will not reflect on the original
56 | authors' reputations.
57 |
58 | Finally, any free program is threatened constantly by software
59 | patents. We wish to avoid the danger that redistributors of a free
60 | program will individually obtain patent licenses, in effect making the
61 | program proprietary. To prevent this, we have made it clear that any
62 | patent must be licensed for everyone's free use or not licensed at all.
63 |
64 | The precise terms and conditions for copying, distribution and
65 | modification follow.
66 |
67 | GNU GENERAL PUBLIC LICENSE
68 | TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
69 |
70 | 0. This License applies to any program or other work which contains
71 | a notice placed by the copyright holder saying it may be distributed
72 | under the terms of this General Public License. The "Program", below,
73 | refers to any such program or work, and a "work based on the Program"
74 | means either the Program or any derivative work under copyright law:
75 | that is to say, a work containing the Program or a portion of it,
76 | either verbatim or with modifications and/or translated into another
77 | language. (Hereinafter, translation is included without limitation in
78 | the term "modification".) Each licensee is addressed as "you".
79 |
80 | Activities other than copying, distribution and modification are not
81 | covered by this License; they are outside its scope. The act of
82 | running the Program is not restricted, and the output from the Program
83 | is covered only if its contents constitute a work based on the
84 | Program (independent of having been made by running the Program).
85 | Whether that is true depends on what the Program does.
86 |
87 | 1. You may copy and distribute verbatim copies of the Program's
88 | source code as you receive it, in any medium, provided that you
89 | conspicuously and appropriately publish on each copy an appropriate
90 | copyright notice and disclaimer of warranty; keep intact all the
91 | notices that refer to this License and to the absence of any warranty;
92 | and give any other recipients of the Program a copy of this License
93 | along with the Program.
94 |
95 | You may charge a fee for the physical act of transferring a copy, and
96 | you may at your option offer warranty protection in exchange for a fee.
97 |
98 | 2. You may modify your copy or copies of the Program or any portion
99 | of it, thus forming a work based on the Program, and copy and
100 | distribute such modifications or work under the terms of Section 1
101 | above, provided that you also meet all of these conditions:
102 |
103 | a) You must cause the modified files to carry prominent notices
104 | stating that you changed the files and the date of any change.
105 |
106 | b) You must cause any work that you distribute or publish, that in
107 | whole or in part contains or is derived from the Program or any
108 | part thereof, to be licensed as a whole at no charge to all third
109 | parties under the terms of this License.
110 |
111 | c) If the modified program normally reads commands interactively
112 | when run, you must cause it, when started running for such
113 | interactive use in the most ordinary way, to print or display an
114 | announcement including an appropriate copyright notice and a
115 | notice that there is no warranty (or else, saying that you provide
116 | a warranty) and that users may redistribute the program under
117 | these conditions, and telling the user how to view a copy of this
118 | License. (Exception: if the Program itself is interactive but
119 | does not normally print such an announcement, your work based on
120 | the Program is not required to print an announcement.)
121 |
122 | These requirements apply to the modified work as a whole. If
123 | identifiable sections of that work are not derived from the Program,
124 | and can be reasonably considered independent and separate works in
125 | themselves, then this License, and its terms, do not apply to those
126 | sections when you distribute them as separate works. But when you
127 | distribute the same sections as part of a whole which is a work based
128 | on the Program, the distribution of the whole must be on the terms of
129 | this License, whose permissions for other licensees extend to the
130 | entire whole, and thus to each and every part regardless of who wrote it.
131 |
132 | Thus, it is not the intent of this section to claim rights or contest
133 | your rights to work written entirely by you; rather, the intent is to
134 | exercise the right to control the distribution of derivative or
135 | collective works based on the Program.
136 |
137 | In addition, mere aggregation of another work not based on the Program
138 | with the Program (or with a work based on the Program) on a volume of
139 | a storage or distribution medium does not bring the other work under
140 | the scope of this License.
141 |
142 | 3. You may copy and distribute the Program (or a work based on it,
143 | under Section 2) in object code or executable form under the terms of
144 | Sections 1 and 2 above provided that you also do one of the following:
145 |
146 | a) Accompany it with the complete corresponding machine-readable
147 | source code, which must be distributed under the terms of Sections
148 | 1 and 2 above on a medium customarily used for software interchange; or,
149 |
150 | b) Accompany it with a written offer, valid for at least three
151 | years, to give any third party, for a charge no more than your
152 | cost of physically performing source distribution, a complete
153 | machine-readable copy of the corresponding source code, to be
154 | distributed under the terms of Sections 1 and 2 above on a medium
155 | customarily used for software interchange; or,
156 |
157 | c) Accompany it with the information you received as to the offer
158 | to distribute corresponding source code. (This alternative is
159 | allowed only for noncommercial distribution and only if you
160 | received the program in object code or executable form with such
161 | an offer, in accord with Subsection b above.)
162 |
163 | The source code for a work means the preferred form of the work for
164 | making modifications to it. For an executable work, complete source
165 | code means all the source code for all modules it contains, plus any
166 | associated interface definition files, plus the scripts used to
167 | control compilation and installation of the executable. However, as a
168 | special exception, the source code distributed need not include
169 | anything that is normally distributed (in either source or binary
170 | form) with the major components (compiler, kernel, and so on) of the
171 | operating system on which the executable runs, unless that component
172 | itself accompanies the executable.
173 |
174 | If distribution of executable or object code is made by offering
175 | access to copy from a designated place, then offering equivalent
176 | access to copy the source code from the same place counts as
177 | distribution of the source code, even though third parties are not
178 | compelled to copy the source along with the object code.
179 |
180 | 4. You may not copy, modify, sublicense, or distribute the Program
181 | except as expressly provided under this License. Any attempt
182 | otherwise to copy, modify, sublicense or distribute the Program is
183 | void, and will automatically terminate your rights under this License.
184 | However, parties who have received copies, or rights, from you under
185 | this License will not have their licenses terminated so long as such
186 | parties remain in full compliance.
187 |
188 | 5. You are not required to accept this License, since you have not
189 | signed it. However, nothing else grants you permission to modify or
190 | distribute the Program or its derivative works. These actions are
191 | prohibited by law if you do not accept this License. Therefore, by
192 | modifying or distributing the Program (or any work based on the
193 | Program), you indicate your acceptance of this License to do so, and
194 | all its terms and conditions for copying, distributing or modifying
195 | the Program or works based on it.
196 |
197 | 6. Each time you redistribute the Program (or any work based on the
198 | Program), the recipient automatically receives a license from the
199 | original licensor to copy, distribute or modify the Program subject to
200 | these terms and conditions. You may not impose any further
201 | restrictions on the recipients' exercise of the rights granted herein.
202 | You are not responsible for enforcing compliance by third parties to
203 | this License.
204 |
205 | 7. If, as a consequence of a court judgment or allegation of patent
206 | infringement or for any other reason (not limited to patent issues),
207 | conditions are imposed on you (whether by court order, agreement or
208 | otherwise) that contradict the conditions of this License, they do not
209 | excuse you from the conditions of this License. If you cannot
210 | distribute so as to satisfy simultaneously your obligations under this
211 | License and any other pertinent obligations, then as a consequence you
212 | may not distribute the Program at all. For example, if a patent
213 | license would not permit royalty-free redistribution of the Program by
214 | all those who receive copies directly or indirectly through you, then
215 | the only way you could satisfy both it and this License would be to
216 | refrain entirely from distribution of the Program.
217 |
218 | If any portion of this section is held invalid or unenforceable under
219 | any particular circumstance, the balance of the section is intended to
220 | apply and the section as a whole is intended to apply in other
221 | circumstances.
222 |
223 | It is not the purpose of this section to induce you to infringe any
224 | patents or other property right claims or to contest validity of any
225 | such claims; this section has the sole purpose of protecting the
226 | integrity of the free software distribution system, which is
227 | implemented by public license practices. Many people have made
228 | generous contributions to the wide range of software distributed
229 | through that system in reliance on consistent application of that
230 | system; it is up to the author/donor to decide if he or she is willing
231 | to distribute software through any other system and a licensee cannot
232 | impose that choice.
233 |
234 | This section is intended to make thoroughly clear what is believed to
235 | be a consequence of the rest of this License.
236 |
237 | 8. If the distribution and/or use of the Program is restricted in
238 | certain countries either by patents or by copyrighted interfaces, the
239 | original copyright holder who places the Program under this License
240 | may add an explicit geographical distribution limitation excluding
241 | those countries, so that distribution is permitted only in or among
242 | countries not thus excluded. In such case, this License incorporates
243 | the limitation as if written in the body of this License.
244 |
245 | 9. The Free Software Foundation may publish revised and/or new versions
246 | of the General Public License from time to time. Such new versions will
247 | be similar in spirit to the present version, but may differ in detail to
248 | address new problems or concerns.
249 |
250 | Each version is given a distinguishing version number. If the Program
251 | specifies a version number of this License which applies to it and "any
252 | later version", you have the option of following the terms and conditions
253 | either of that version or of any later version published by the Free
254 | Software Foundation. If the Program does not specify a version number of
255 | this License, you may choose any version ever published by the Free Software
256 | Foundation.
257 |
258 | 10. If you wish to incorporate parts of the Program into other free
259 | programs whose distribution conditions are different, write to the author
260 | to ask for permission. For software which is copyrighted by the Free
261 | Software Foundation, write to the Free Software Foundation; we sometimes
262 | make exceptions for this. Our decision will be guided by the two goals
263 | of preserving the free status of all derivatives of our free software and
264 | of promoting the sharing and reuse of software generally.
265 |
266 | NO WARRANTY
267 |
268 | 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
269 | FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
270 | OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
271 | PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
272 | OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
273 | MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
274 | TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
275 | PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
276 | REPAIR OR CORRECTION.
277 |
278 | 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
279 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
280 | REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
281 | INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
282 | OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
283 | TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
284 | YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
285 | PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
286 | POSSIBILITY OF SUCH DAMAGES.
287 |
288 | END OF TERMS AND CONDITIONS
289 |
290 | How to Apply These Terms to Your New Programs
291 |
292 | If you develop a new program, and you want it to be of the greatest
293 | possible use to the public, the best way to achieve this is to make it
294 | free software which everyone can redistribute and change under these terms.
295 |
296 | To do so, attach the following notices to the program. It is safest
297 | to attach them to the start of each source file to most effectively
298 | convey the exclusion of warranty; and each file should have at least
299 | the "copyright" line and a pointer to where the full notice is found.
300 |
301 |
302 | Copyright (C)
303 |
304 | This program is free software; you can redistribute it and/or modify
305 | it under the terms of the GNU General Public License as published by
306 | the Free Software Foundation; either version 2 of the License, or
307 | (at your option) any later version.
308 |
309 | This program is distributed in the hope that it will be useful,
310 | but WITHOUT ANY WARRANTY; without even the implied warranty of
311 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
312 | GNU General Public License for more details.
313 |
314 | You should have received a copy of the GNU General Public License
315 | along with this program; if not, write to the Free Software
316 | Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
317 |
318 |
319 | Also add information on how to contact you by electronic and paper mail.
320 |
321 | If the program is interactive, make it output a short notice like this
322 | when it starts in an interactive mode:
323 |
324 | Gnomovision version 69, Copyright (C) year name of author
325 | Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
326 | This is free software, and you are welcome to redistribute it
327 | under certain conditions; type `show c' for details.
328 |
329 | The hypothetical commands `show w' and `show c' should show the appropriate
330 | parts of the General Public License. Of course, the commands you use may
331 | be called something other than `show w' and `show c'; they could even be
332 | mouse-clicks or menu items--whatever suits your program.
333 |
334 | You should also get your employer (if you work as a programmer) or your
335 | school, if any, to sign a "copyright disclaimer" for the program, if
336 | necessary. Here is a sample; alter the names:
337 |
338 | Yoyodyne, Inc., hereby disclaims all copyright interest in the program
339 | `Gnomovision' (which makes passes at compilers) written by James Hacker.
340 |
341 | , 1 April 1989
342 | Ty Coon, President of Vice
343 |
344 | This General Public License does not permit incorporating your program into
345 | proprietary programs. If your program is a subroutine library, you may
346 | consider it more useful to permit linking proprietary applications with the
347 | library. If this is what you want to do, use the GNU Library General
348 | Public License instead of this License.
349 |
--------------------------------------------------------------------------------
/box/curl.LICENSE:
--------------------------------------------------------------------------------
1 | CURL LICENSE
2 |
3 | Permission to use, copy, modify, and distribute this software for any purpose
4 | with or without fee is hereby granted, provided that the above copyright notice
5 | and this permission notice appear in all copies.
6 |
7 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
8 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
9 | FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT
10 | SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
11 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
12 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
13 | SOFTWARE.
14 |
15 | Except as contained in this notice, the name of a copyright holder shall not be
16 | used in advertising or otherwise to promote the sale, use or other dealings in
17 | this Software without prior written authorization of the copyright holder.
18 |
--------------------------------------------------------------------------------
/box/install-k8s-debugbox.sh:
--------------------------------------------------------------------------------
1 | #!/tmp/box/busybox sh
2 |
3 | if [ ! -e /tmp/box/bin/sh ]; then
4 | mkdir -p /tmp/box/bin
5 |
6 | if [ ! -e /tmp/box/busybox ]; then
7 | cp -r /usr/local/k8s-debugbox/box/* /tmp/box
8 | fi
9 |
10 | echo "Installing Busybox"
11 | /tmp/box/busybox --install /tmp/box/bin
12 |
13 | echo "Installing toybox"
14 | for i in $(/tmp/box/toybox); do [ -e /tmp/box/bin/$i ] || ln /tmp/box/toybox /tmp/box/bin/$i; done
15 |
16 | echo "Installing curl"
17 | [ -e /tmp/box/bin/curl ] || ln /tmp/box/curl /tmp/box/bin/curl
18 |
19 | echo "Installing vim"
20 | [ -e /tmp/box/bin/vim ] || ln /tmp/box/vim /tmp/box/bin/vim
21 |
22 | [ -e /tmp/box/sh ] || cp /box/sh /tmp/box/sh
23 | chmod 0755 /tmp/box/sh
24 | fi
25 |
--------------------------------------------------------------------------------
/box/sh:
--------------------------------------------------------------------------------
1 | #!/tmp/box/bin/sh
2 |
3 | shell=$(command -v bash) || shell=$(command -v sh) || shell=/tmp/box/bin/sh
4 | PS1='[\u@\h:\W] [debugbox] \$ ' PATH=$PATH:/tmp/box/bin CURL_CA_BUNDLE=/tmp/box/cacert.pem TERMINFO=/tmp/box/etc/terminfo VIM=/tmp/box/etc exec $shell "$@"
5 |
--------------------------------------------------------------------------------
/box/toybox.LICENSE:
--------------------------------------------------------------------------------
1 | Toybox is released under the Zero Clause BSD license (SPDX: 0BSD)
2 |
3 | Copyright (C) 2006, 2018 by Rob Landley
4 |
5 | Permission to use, copy, modify, and/or distribute this software for any
6 | purpose with or without fee is hereby granted.
7 |
8 | THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 | WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 | MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 | ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 | WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 | ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 | OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 |
--------------------------------------------------------------------------------
/box/uninstall-k8s-debugbox.sh:
--------------------------------------------------------------------------------
1 | #!/tmp/box/busybox sh
2 |
3 | rm -rf /tmp/box
4 |
--------------------------------------------------------------------------------
/box/vim.LICENSE:
--------------------------------------------------------------------------------
1 | *uganda.txt* For Vim version 8.1. Last change: 2018 May 17
2 |
3 |
4 | VIM REFERENCE MANUAL by Bram Moolenaar
5 |
6 |
7 | *uganda* *Uganda* *copying* *copyright* *license*
8 | SUMMARY
9 | *iccf* *ICCF*
10 | Vim is Charityware. You can use and copy it as much as you like, but you are
11 | encouraged to make a donation for needy children in Uganda. Please see |kcc|
12 | below or visit the ICCF web site, available at these URLs:
13 |
14 | http://iccf-holland.org/
15 | http://www.vim.org/iccf/
16 | http://www.iccf.nl/
17 |
18 | You can also sponsor the development of Vim. Vim sponsors can vote for
19 | features. See |sponsor|. The money goes to Uganda anyway.
20 |
21 | The Open Publication License applies to the Vim documentation, see
22 | |manual-copyright|.
23 |
24 | === begin of license ===
25 |
26 | VIM LICENSE
27 |
28 | I) There are no restrictions on distributing unmodified copies of Vim except
29 | that they must include this license text. You can also distribute
30 | unmodified parts of Vim, likewise unrestricted except that they must
31 | include this license text. You are also allowed to include executables
32 | that you made from the unmodified Vim sources, plus your own usage
33 | examples and Vim scripts.
34 |
35 | II) It is allowed to distribute a modified (or extended) version of Vim,
36 | including executables and/or source code, when the following four
37 | conditions are met:
38 | 1) This license text must be included unmodified.
39 | 2) The modified Vim must be distributed in one of the following five ways:
40 | a) If you make changes to Vim yourself, you must clearly describe in
41 | the distribution how to contact you. When the maintainer asks you
42 | (in any way) for a copy of the modified Vim you distributed, you
43 | must make your changes, including source code, available to the
44 | maintainer without fee. The maintainer reserves the right to
45 | include your changes in the official version of Vim. What the
46 | maintainer will do with your changes and under what license they
47 | will be distributed is negotiable. If there has been no negotiation
48 | then this license, or a later version, also applies to your changes.
49 | The current maintainer is Bram Moolenaar . If this
50 | changes it will be announced in appropriate places (most likely
51 | vim.sf.net, www.vim.org and/or comp.editors). When it is completely
52 | impossible to contact the maintainer, the obligation to send him
53 | your changes ceases. Once the maintainer has confirmed that he has
54 | received your changes they will not have to be sent again.
55 | b) If you have received a modified Vim that was distributed as
56 | mentioned under a) you are allowed to further distribute it
57 | unmodified, as mentioned at I). If you make additional changes the
58 | text under a) applies to those changes.
59 | c) Provide all the changes, including source code, with every copy of
60 | the modified Vim you distribute. This may be done in the form of a
61 | context diff. You can choose what license to use for new code you
62 | add. The changes and their license must not restrict others from
63 | making their own changes to the official version of Vim.
64 | d) When you have a modified Vim which includes changes as mentioned
65 | under c), you can distribute it without the source code for the
66 | changes if the following three conditions are met:
67 | - The license that applies to the changes permits you to distribute
68 | the changes to the Vim maintainer without fee or restriction, and
69 | permits the Vim maintainer to include the changes in the official
70 | version of Vim without fee or restriction.
71 | - You keep the changes for at least three years after last
72 | distributing the corresponding modified Vim. When the maintainer
73 | or someone who you distributed the modified Vim to asks you (in
74 | any way) for the changes within this period, you must make them
75 | available to him.
76 | - You clearly describe in the distribution how to contact you. This
77 | contact information must remain valid for at least three years
78 | after last distributing the corresponding modified Vim, or as long
79 | as possible.
80 | e) When the GNU General Public License (GPL) applies to the changes,
81 | you can distribute the modified Vim under the GNU GPL version 2 or
82 | any later version.
83 | 3) A message must be added, at least in the output of the ":version"
84 | command and in the intro screen, such that the user of the modified Vim
85 | is able to see that it was modified. When distributing as mentioned
86 | under 2)e) adding the message is only required for as far as this does
87 | not conflict with the license used for the changes.
88 | 4) The contact information as required under 2)a) and 2)d) must not be
89 | removed or changed, except that the person himself can make
90 | corrections.
91 |
92 | III) If you distribute a modified version of Vim, you are encouraged to use
93 | the Vim license for your changes and make them available to the
94 | maintainer, including the source code. The preferred way to do this is
95 | by e-mail or by uploading the files to a server and e-mailing the URL.
96 | If the number of changes is small (e.g., a modified Makefile) e-mailing a
97 | context diff will do. The e-mail address to be used is
98 |
99 |
100 | IV) It is not allowed to remove this license from the distribution of the Vim
101 | sources, parts of it or from a modified version. You may use this
102 | license for previous Vim releases instead of the license that they came
103 | with, at your option.
104 |
105 | === end of license ===
106 |
107 | Note:
108 |
109 | - If you are happy with Vim, please express that by reading the rest of this
110 | file and consider helping needy children in Uganda.
111 |
112 | - If you want to support further Vim development consider becoming a
113 | |sponsor|. The money goes to Uganda anyway.
114 |
115 | - According to Richard Stallman the Vim license is GNU GPL compatible.
116 | A few minor changes have been made since he checked it, but that should not
117 | make a difference.
118 |
119 | - If you link Vim with a library that goes under the GNU GPL, this limits
120 | further distribution to the GNU GPL. Also when you didn't actually change
121 | anything in Vim.
122 |
123 | - Once a change is included that goes under the GNU GPL, this forces all
124 | further changes to also be made under the GNU GPL or a compatible license.
125 |
126 | - If you distribute a modified version of Vim, you can include your name and
127 | contact information with the "--with-modified-by" configure argument or the
128 | MODIFIED_BY define.
129 |
130 | ==============================================================================
131 | Kibaale Children's Centre *kcc* *Kibaale* *charity*
132 |
133 | Kibaale Children's Centre (KCC) is located in Kibaale, a small town in the
134 | south of Uganda, near Tanzania, in East Africa. The area is known as Rakai
135 | District. The population is mostly farmers. Although people are poor, there
136 | is enough food. But this district is suffering from AIDS more than any other
137 | part of the world. Some say that it started there. Estimations are that 10
138 | to 30% of the Ugandans are infected with HIV. Because parents die, there are
139 | many orphans. In this district about 60,000 children have lost one or both
140 | parents, out of a population of 350,000. And this is still continuing.
141 |
142 | The children need a lot of help. The KCC is working hard to provide the needy
143 | with food, medical care and education. Food and medical care to keep them
144 | healthy now, and education so that they can take care of themselves in the
145 | future. KCC works on a Christian base, but help is given to children of any
146 | religion.
147 |
148 | The key to solving the problems in this area is education. This has been
149 | neglected in the past years with president Idi Amin and the following civil
150 | wars. Now that the government is stable again, the children and parents have
151 | to learn how to take care of themselves and how to avoid infections. There is
152 | also help for people who are ill and hungry, but the primary goal is to
153 | prevent people from getting ill and to teach them how to grow healthy food.
154 |
155 | Most of the orphans are living in an extended family. An uncle or older
156 | sister is taking care of them. Because these families are big and the income
157 | (if any) is low, a child is lucky if it gets healthy food. Clothes, medical
158 | care and schooling is beyond its reach. To help these needy children, a
159 | sponsorship program was put into place. A child can be financially adopted.
160 | For a few dollars a month KCC sees to it that the child gets indispensable
161 | items, is healthy, goes to school and KCC takes care of anything else that
162 | needs to be done for the child and the family that supports it.
163 |
164 | Besides helping the child directly, the environment where the child grows up
165 | needs to be improved. KCC helps schools to improve their teaching methods.
166 | There is a demonstration school at the centre and teacher trainings are given.
167 | Health workers are being trained, hygiene education is carried out and
168 | households are stimulated to build a proper latrine. I helped setting up a
169 | production site for cement slabs. These are used to build a good latrine.
170 | They are sold below cost price.
171 |
172 | There is a small clinic at the project, which provides children and their
173 | family with medical help. When needed, transport to a hospital is offered.
174 | Immunization programs are carried out and help is provided when an epidemic is
175 | breaking out (measles and cholera have been a problem).
176 | *donate*
177 | Summer 1994 to summer 1995 I spent a whole year at the centre, working as a
178 | volunteer. I have helped to expand the centre and worked in the area of water
179 | and sanitation. I learned that the help that the KCC provides really helps.
180 | When I came back to Holland, I wanted to continue supporting KCC. To do this
181 | I'm raising funds and organizing the sponsorship program. Please consider one
182 | of these possibilities:
183 |
184 | 1. Sponsor a child in primary school: 17 euro a month (or more).
185 | 2. Sponsor a child in secondary school: 25 euro a month (or more).
186 | 3. Sponsor the clinic: Any amount a month or quarter
187 | 4. A one-time donation
188 |
189 | Compared with other organizations that do child sponsorship the amounts are
190 | very low. This is because the money goes directly to the centre. Less than
191 | 5% is used for administration. This is possible because this is a small
192 | organization that works with volunteers. If you would like to sponsor a
193 | child, you should have the intention to do this for at least one year.
194 |
195 | How do you know that the money will be spent right? First of all you have my
196 | personal guarantee as the author of Vim. I trust the people that are working
197 | at the centre, I know them personally. Furthermore, the centre has been
198 | co-sponsored and inspected by World Vision, Save the Children Fund and is now
199 | under the supervision of Pacific Academy Outreach Society. The centre is
200 | visited about once a year to check the progress (at our own cost). I have
201 | visited the centre myself many times, starting in 1993. The visit reports are
202 | on the ICCF web site.
203 |
204 | If you have any further questions, send me e-mail: .
205 |
206 | The address of the centre is:
207 | Kibaale Children's Centre
208 | p.o. box 1658
209 | Masaka, Uganda, East Africa
210 |
211 | Sending money: *iccf-donations*
212 |
213 | Check the ICCF web site for the latest information! See |iccf| for the URL.
214 |
215 |
216 | USA: The methods mentioned below can be used.
217 | Sending a check to the Nehemiah Group Outreach Society (NGOS)
218 | is no longer possible, unfortunately. We are looking for
219 | another way to get you an IRS tax receipt.
220 | For sponsoring a child contact KCF in Canada (see below). US
221 | checks can be sent to them to lower banking costs.
222 |
223 | Canada: Contact Kibaale Children's Fund (KCF) in Surrey, Canada. They
224 | take care of the Canadian sponsors for the children in
225 | Kibaale. KCF forwards 100% of the money to the project in
226 | Uganda. You can send them a one time donation directly.
227 | Please send me a note so that I know what has been donated
228 | because of Vim. Ask KCF for information about sponsorship.
229 | Kibaale Children's Fund c/o Pacific Academy
230 | 10238-168 Street
231 | Surrey, B.C. V4N 1Z4
232 | Canada
233 | Phone: 604-581-5353
234 | If you make a donation to Kibaale Children's Fund (KCF) you
235 | will receive a tax receipt which can be submitted with your
236 | tax return.
237 |
238 | Holland: Transfer to the account of "Stichting ICCF Holland" in Lisse.
239 | This will allow for tax deduction if you live in Holland.
240 | Postbank, nr. 4548774
241 | IBAN: NL95 INGB 0004 5487 74
242 |
243 | Germany: It is possible to make donations that allow for a tax return.
244 | Check the ICCF web site for the latest information:
245 | http://iccf-holland.org/germany.html
246 |
247 | World: Use a postal money order. That should be possible from any
248 | country, mostly from the post office. Use this name (which is
249 | in my passport): "Abraham Moolenaar". Use Euro for the
250 | currency if possible.
251 |
252 | Europe: Use a bank transfer if possible. Your bank should have a form
253 | that you can use for this. See "Others" below for the swift
254 | code and IBAN number.
255 | Any other method should work. Ask for information about
256 | sponsorship.
257 |
258 | Credit Card: You can use PayPal to send money with a Credit card. This is
259 | the most widely used Internet based payment system. It's
260 | really simple to use. Use this link to find more info:
261 | https://www.paypal.com/en_US/mrb/pal=XAC62PML3GF8Q
262 | The e-mail address for sending the money to is:
263 | Bram@iccf-holland.org
264 | For amounts above 400 Euro ($500) sending a check is
265 | preferred.
266 |
267 | Others: Transfer to one of these accounts if possible:
268 | Postbank, account 4548774
269 | Swift code: INGB NL 2A
270 | IBAN: NL95 INGB 0004 5487 74
271 | under the name "stichting ICCF Holland", Lisse
272 | If that doesn't work:
273 | Rabobank Lisse, account 3765.05.117
274 | Swift code: RABO NL 2U
275 | under the name "Bram Moolenaar", Lisse
276 | Otherwise, send a check in euro or US dollars to the address
277 | below. Minimal amount: $70 (my bank does not accept smaller
278 | amounts for foreign check, sorry)
279 |
280 | Address to send checks to:
281 | Bram Moolenaar
282 | Finsterruetihof 1
283 | 8134 Adliswil
284 | Switzerland
285 |
286 | This address is expected to be valid for a long time.
287 |
288 | vim:tw=78:ts=8:noet:ft=help:norl:
289 |
--------------------------------------------------------------------------------
/create-release.sh:
--------------------------------------------------------------------------------
1 | #!/bin/sh
2 |
3 | if [ ! -e bin/k8s-debugbox ]; then
4 | echo "'$(basename "$0")' must be run in 'k8s-debugbox' directory!" >&2
5 | exit 1
6 | fi
7 |
8 | if [ ! -e box/busybox ]; then
9 | echo "'bootstrap.sh' must be run first!" >&2
10 | exit 1
11 | fi
12 |
13 | if [ $# -ne 1 ]; then
14 | echo "Usage:" >&2
15 | echo " $(basename $0) VERSION" >&2
16 | exit 1
17 | fi
18 |
19 | mkdir -p "releases/k8s-debugbox-$1/box"
20 | echo "$1" >"releases/k8s-debugbox-$1/box/VERSION"
21 | cp -r box/busybox box/toybox box/curl box/cacert.pem box/vim box/etc "releases/k8s-debugbox-$1/box"
22 | git archive HEAD --prefix=k8s-debugbox-$1/ -o releases/k8s-debugbox-$1.tar
23 | git archive HEAD --prefix=k8s-debugbox-$1/ -o releases/k8s-debugbox-$1.zip
24 | (cd releases && tar --owner=root --group=root -rf k8s-debugbox-$1.tar "k8s-debugbox-$1" && gzip -9f k8s-debugbox-$1.tar)
25 | (cd releases && zip -qur k8s-debugbox-$1.zip "k8s-debugbox-$1")
26 | rm -rf "releases/k8s-debugbox-$1"
27 |
--------------------------------------------------------------------------------
/install.bat:
--------------------------------------------------------------------------------
1 | @echo off
2 |
3 | rem Use sh instead of bash to prevent calling Windows Subsystem for Linux bash, which comes first in PATH.
4 | sh %~dp0\install.sh %*
5 |
--------------------------------------------------------------------------------
/install.sh:
--------------------------------------------------------------------------------
1 | #!/bin/sh
2 |
3 | debugbox_dir=${HOME}/.k8s-debugbox
4 |
5 | findWritablePathDir()
6 | {
7 | old_ifs="$IFS"
8 | IFS=:
9 | for dir in $PATH; do
10 | if [ -w $dir ]; then
11 | IFS="$old_ifs"
12 | echo "$dir"
13 | return 0
14 | fi
15 | done
16 | IFS="$old_ifs"
17 | return 1
18 | }
19 |
20 | if [ ! -e bin/k8s-debugbox ]; then
21 | echo "'$(basename "$0")' must be run in 'k8s-debugbox' directory!" >&2
22 | exit 1
23 | fi
24 |
25 | echo "Copying static binaries to '${debugbox_dir}'"
26 | mkdir -p ${debugbox_dir}
27 | cp -r box ${debugbox_dir}
28 |
29 | if writable_path_dir="$(findWritablePathDir)"; then
30 | echo "Copying 'k8s-debugbox' script to '${writable_path_dir}'"
31 | cp bin/k8s-debugbox "${writable_path_dir}"
32 | if command -v bash.exe >/dev/null 2>&1; then
33 | cp bin/k8s-debugbox.bat "${writable_path_dir}"
34 | fi
35 | else
36 | echo "Can't find writable directory in PATH. Please add bin/k8s-debugbox to PATH manually!"
37 | fi
38 |
--------------------------------------------------------------------------------