1 This is gpgme.info, produced by makeinfo version 5.2 from gpgme.texi.
3 Copyright © 2002–2008, 2010, 2012–2016 g10 Code GmbH.
5 Permission is granted to copy, distribute and/or modify this
6 document under the terms of the GNU General Public License as
7 published by the Free Software Foundation; either version 3 of the
8 License, or (at your option) any later version. The text of the
9 license can be found in the section entitled “Copying”.
11 This document is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
14 Public License for more details.
15 INFO-DIR-SECTION GNU Libraries
17 * GPGME: (gpgme). Adding support for cryptography to your program.
20 This file documents the GPGME library.
22 This is Edition 1.8.0-beta50, last updated 16 November 2016, of ‘The
23 ‘GnuPG Made Easy’ Reference Manual’, for Version 1.8.0-beta50.
25 Copyright © 2002–2008, 2010, 2012–2016 g10 Code GmbH.
27 Permission is granted to copy, distribute and/or modify this
28 document under the terms of the GNU General Public License as
29 published by the Free Software Foundation; either version 3 of the
30 License, or (at your option) any later version. The text of the
31 license can be found in the section entitled “Copying”.
33 This document is distributed in the hope that it will be useful, but
34 WITHOUT ANY WARRANTY; without even the implied warranty of
35 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
36 Public License for more details.
39 File: gpgme.info, Node: Library Copying, Next: Copying, Prev: Deprecated Functions, Up: Top
41 GNU Lesser General Public License
42 *********************************
44 Version 2.1, February 1999
46 Copyright © 1991, 1999 Free Software Foundation, Inc.
47 59 Temple Place – Suite 330, Boston, MA 02111-1307, USA
49 Everyone is permitted to copy and distribute verbatim copies
50 of this license document, but changing it is not allowed.
52 [This is the first released version of the Lesser GPL. It also counts
53 as the successor of the GNU Library Public License, version 2, hence the
59 The licenses for most software are designed to take away your freedom to
60 share and change it. By contrast, the GNU General Public Licenses are
61 intended to guarantee your freedom to share and change free software—to
62 make sure the software is free for all its users.
64 This license, the Lesser General Public License, applies to some
65 specially designated software—typically libraries—of the Free Software
66 Foundation and other authors who decide to use it. You can use it too,
67 but we suggest you first think carefully about whether this license or
68 the ordinary General Public License is the better strategy to use in any
69 particular case, based on the explanations below.
71 When we speak of free software, we are referring to freedom of use,
72 not price. Our General Public Licenses are designed to make sure that
73 you have the freedom to distribute copies of free software (and charge
74 for this service if you wish); that you receive source code or can get
75 it if you want it; that you can change the software and use pieces of it
76 in new free programs; and that you are informed that you can do these
79 To protect your rights, we need to make restrictions that forbid
80 distributors to deny you these rights or to ask you to surrender these
81 rights. These restrictions translate to certain responsibilities for
82 you if you distribute copies of the library or if you modify it.
84 For example, if you distribute copies of the library, whether gratis
85 or for a fee, you must give the recipients all the rights that we gave
86 you. You must make sure that they, too, receive or can get the source
87 code. If you link other code with the library, you must provide
88 complete object files to the recipients, so that they can relink them
89 with the library after making changes to the library and recompiling it.
90 And you must show them these terms so they know their rights.
92 We protect your rights with a two-step method: (1) we copyright the
93 library, and (2) we offer you this license, which gives you legal
94 permission to copy, distribute and/or modify the library.
96 To protect each distributor, we want to make it very clear that there
97 is no warranty for the free library. Also, if the library is modified
98 by someone else and passed on, the recipients should know that what they
99 have is not the original version, so that the original author’s
100 reputation will not be affected by problems that might be introduced by
103 Finally, software patents pose a constant threat to the existence of
104 any free program. We wish to make sure that a company cannot
105 effectively restrict the users of a free program by obtaining a
106 restrictive license from a patent holder. Therefore, we insist that any
107 patent license obtained for a version of the library must be consistent
108 with the full freedom of use specified in this license.
110 Most GNU software, including some libraries, is covered by the
111 ordinary GNU General Public License. This license, the GNU Lesser
112 General Public License, applies to certain designated libraries, and is
113 quite different from the ordinary General Public License. We use this
114 license for certain libraries in order to permit linking those libraries
115 into non-free programs.
117 When a program is linked with a library, whether statically or using
118 a shared library, the combination of the two is legally speaking a
119 combined work, a derivative of the original library. The ordinary
120 General Public License therefore permits such linking only if the entire
121 combination fits its criteria of freedom. The Lesser General Public
122 License permits more lax criteria for linking other code with the
125 We call this license the "Lesser" General Public License because it
126 does _Less_ to protect the user’s freedom than the ordinary General
127 Public License. It also provides other free software developers Less of
128 an advantage over competing non-free programs. These disadvantages are
129 the reason we use the ordinary General Public License for many
130 libraries. However, the Lesser license provides advantages in certain
131 special circumstances.
133 For example, on rare occasions, there may be a special need to
134 encourage the widest possible use of a certain library, so that it
135 becomes a de-facto standard. To achieve this, non-free programs must be
136 allowed to use the library. A more frequent case is that a free library
137 does the same job as widely used non-free libraries. In this case,
138 there is little to gain by limiting the free library to free software
139 only, so we use the Lesser General Public License.
141 In other cases, permission to use a particular library in non-free
142 programs enables a greater number of people to use a large body of free
143 software. For example, permission to use the GNU C Library in non-free
144 programs enables many more people to use the whole GNU operating system,
145 as well as its variant, the GNU/Linux operating system.
147 Although the Lesser General Public License is Less protective of the
148 users’ freedom, it does ensure that the user of a program that is linked
149 with the Library has the freedom and the wherewithal to run that program
150 using a modified version of the Library.
152 The precise terms and conditions for copying, distribution and
153 modification follow. Pay close attention to the difference between a
154 “work based on the library” and a “work that uses the library”. The
155 former contains code derived from the library, whereas the latter must
156 be combined with the library in order to run.
158 GNU LESSER GENERAL PUBLIC LICENSE
159 TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
161 0. This License Agreement applies to any software library or other
162 program which contains a notice placed by the copyright holder or
163 other authorized party saying it may be distributed under the terms
164 of this Lesser General Public License (also called “this License”).
165 Each licensee is addressed as “you”.
167 A “library” means a collection of software functions and/or data
168 prepared so as to be conveniently linked with application programs
169 (which use some of those functions and data) to form executables.
171 The “Library”, below, refers to any such software library or work
172 which has been distributed under these terms. A “work based on the
173 Library” means either the Library or any derivative work under
174 copyright law: that is to say, a work containing the Library or a
175 portion of it, either verbatim or with modifications and/or
176 translated straightforwardly into another language. (Hereinafter,
177 translation is included without limitation in the term
180 “Source code” for a work means the preferred form of the work for
181 making modifications to it. For a library, complete source code
182 means all the source code for all modules it contains, plus any
183 associated interface definition files, plus the scripts used to
184 control compilation and installation of the library.
186 Activities other than copying, distribution and modification are
187 not covered by this License; they are outside its scope. The act
188 of running a program using the Library is not restricted, and
189 output from such a program is covered only if its contents
190 constitute a work based on the Library (independent of the use of
191 the Library in a tool for writing it). Whether that is true
192 depends on what the Library does and what the program that uses the
195 1. You may copy and distribute verbatim copies of the Library’s
196 complete source code as you receive it, in any medium, provided
197 that you conspicuously and appropriately publish on each copy an
198 appropriate copyright notice and disclaimer of warranty; keep
199 intact all the notices that refer to this License and to the
200 absence of any warranty; and distribute a copy of this License
201 along with the Library.
203 You may charge a fee for the physical act of transferring a copy,
204 and you may at your option offer warranty protection in exchange
207 2. You may modify your copy or copies of the Library or any portion of
208 it, thus forming a work based on the Library, and copy and
209 distribute such modifications or work under the terms of Section 1
210 above, provided that you also meet all of these conditions:
212 a. The modified work must itself be a software library.
214 b. You must cause the files modified to carry prominent notices
215 stating that you changed the files and the date of any change.
217 c. You must cause the whole of the work to be licensed at no
218 charge to all third parties under the terms of this License.
220 d. If a facility in the modified Library refers to a function or
221 a table of data to be supplied by an application program that
222 uses the facility, other than as an argument passed when the
223 facility is invoked, then you must make a good faith effort to
224 ensure that, in the event an application does not supply such
225 function or table, the facility still operates, and performs
226 whatever part of its purpose remains meaningful.
228 (For example, a function in a library to compute square roots
229 has a purpose that is entirely well-defined independent of the
230 application. Therefore, Subsection 2d requires that any
231 application-supplied function or table used by this function
232 must be optional: if the application does not supply it, the
233 square root function must still compute square roots.)
235 These requirements apply to the modified work as a whole. If
236 identifiable sections of that work are not derived from the
237 Library, and can be reasonably considered independent and separate
238 works in themselves, then this License, and its terms, do not apply
239 to those sections when you distribute them as separate works. But
240 when you distribute the same sections as part of a whole which is a
241 work based on the Library, the distribution of the whole must be on
242 the terms of this License, whose permissions for other licensees
243 extend to the entire whole, and thus to each and every part
244 regardless of who wrote it.
246 Thus, it is not the intent of this section to claim rights or
247 contest your rights to work written entirely by you; rather, the
248 intent is to exercise the right to control the distribution of
249 derivative or collective works based on the Library.
251 In addition, mere aggregation of another work not based on the
252 Library with the Library (or with a work based on the Library) on a
253 volume of a storage or distribution medium does not bring the other
254 work under the scope of this License.
256 3. You may opt to apply the terms of the ordinary GNU General Public
257 License instead of this License to a given copy of the Library. To
258 do this, you must alter all the notices that refer to this License,
259 so that they refer to the ordinary GNU General Public License,
260 version 2, instead of to this License. (If a newer version than
261 version 2 of the ordinary GNU General Public License has appeared,
262 then you can specify that version instead if you wish.) Do not
263 make any other change in these notices.
265 Once this change is made in a given copy, it is irreversible for
266 that copy, so the ordinary GNU General Public License applies to
267 all subsequent copies and derivative works made from that copy.
269 This option is useful when you wish to copy part of the code of the
270 Library into a program that is not a library.
272 4. You may copy and distribute the Library (or a portion or derivative
273 of it, under Section 2) in object code or executable form under the
274 terms of Sections 1 and 2 above provided that you accompany it with
275 the complete corresponding machine-readable source code, which must
276 be distributed under the terms of Sections 1 and 2 above on a
277 medium customarily used for software interchange.
279 If distribution of object code is made by offering access to copy
280 from a designated place, then offering equivalent access to copy
281 the source code from the same place satisfies the requirement to
282 distribute the source code, even though third parties are not
283 compelled to copy the source along with the object code.
285 5. A program that contains no derivative of any portion of the
286 Library, but is designed to work with the Library by being compiled
287 or linked with it, is called a “work that uses the Library”. Such
288 a work, in isolation, is not a derivative work of the Library, and
289 therefore falls outside the scope of this License.
291 However, linking a “work that uses the Library” with the Library
292 creates an executable that is a derivative of the Library (because
293 it contains portions of the Library), rather than a “work that uses
294 the library”. The executable is therefore covered by this License.
295 Section 6 states terms for distribution of such executables.
297 When a “work that uses the Library” uses material from a header
298 file that is part of the Library, the object code for the work may
299 be a derivative work of the Library even though the source code is
300 not. Whether this is true is especially significant if the work
301 can be linked without the Library, or if the work is itself a
302 library. The threshold for this to be true is not precisely
305 If such an object file uses only numerical parameters, data
306 structure layouts and accessors, and small macros and small inline
307 functions (ten lines or less in length), then the use of the object
308 file is unrestricted, regardless of whether it is legally a
309 derivative work. (Executables containing this object code plus
310 portions of the Library will still fall under Section 6.)
312 Otherwise, if the work is a derivative of the Library, you may
313 distribute the object code for the work under the terms of Section
314 6. Any executables containing that work also fall under Section 6,
315 whether or not they are linked directly with the Library itself.
317 6. As an exception to the Sections above, you may also combine or link
318 a “work that uses the Library” with the Library to produce a work
319 containing portions of the Library, and distribute that work under
320 terms of your choice, provided that the terms permit modification
321 of the work for the customer’s own use and reverse engineering for
322 debugging such modifications.
324 You must give prominent notice with each copy of the work that the
325 Library is used in it and that the Library and its use are covered
326 by this License. You must supply a copy of this License. If the
327 work during execution displays copyright notices, you must include
328 the copyright notice for the Library among them, as well as a
329 reference directing the user to the copy of this License. Also,
330 you must do one of these things:
332 a. Accompany the work with the complete corresponding
333 machine-readable source code for the Library including
334 whatever changes were used in the work (which must be
335 distributed under Sections 1 and 2 above); and, if the work is
336 an executable linked with the Library, with the complete
337 machine-readable “work that uses the Library”, as object code
338 and/or source code, so that the user can modify the Library
339 and then relink to produce a modified executable containing
340 the modified Library. (It is understood that the user who
341 changes the contents of definitions files in the Library will
342 not necessarily be able to recompile the application to use
343 the modified definitions.)
345 b. Use a suitable shared library mechanism for linking with the
346 Library. A suitable mechanism is one that (1) uses at run
347 time a copy of the library already present on the user’s
348 computer system, rather than copying library functions into
349 the executable, and (2) will operate properly with a modified
350 version of the library, if the user installs one, as long as
351 the modified version is interface-compatible with the version
352 that the work was made with.
354 c. Accompany the work with a written offer, valid for at least
355 three years, to give the same user the materials specified in
356 Subsection 6a, above, for a charge no more than the cost of
357 performing this distribution.
359 d. If distribution of the work is made by offering access to copy
360 from a designated place, offer equivalent access to copy the
361 above specified materials from the same place.
363 e. Verify that the user has already received a copy of these
364 materials or that you have already sent this user a copy.
366 For an executable, the required form of the “work that uses the
367 Library” must include any data and utility programs needed for
368 reproducing the executable from it. However, as a special
369 exception, the materials to be distributed need not include
370 anything that is normally distributed (in either source or binary
371 form) with the major components (compiler, kernel, and so on) of
372 the operating system on which the executable runs, unless that
373 component itself accompanies the executable.
375 It may happen that this requirement contradicts the license
376 restrictions of other proprietary libraries that do not normally
377 accompany the operating system. Such a contradiction means you
378 cannot use both them and the Library together in an executable that
381 7. You may place library facilities that are a work based on the
382 Library side-by-side in a single library together with other
383 library facilities not covered by this License, and distribute such
384 a combined library, provided that the separate distribution of the
385 work based on the Library and of the other library facilities is
386 otherwise permitted, and provided that you do these two things:
388 a. Accompany the combined library with a copy of the same work
389 based on the Library, uncombined with any other library
390 facilities. This must be distributed under the terms of the
393 b. Give prominent notice with the combined library of the fact
394 that part of it is a work based on the Library, and explaining
395 where to find the accompanying uncombined form of the same
398 8. You may not copy, modify, sublicense, link with, or distribute the
399 Library except as expressly provided under this License. Any
400 attempt otherwise to copy, modify, sublicense, link with, or
401 distribute the Library is void, and will automatically terminate
402 your rights under this License. However, parties who have received
403 copies, or rights, from you under this License will not have their
404 licenses terminated so long as such parties remain in full
407 9. You are not required to accept this License, since you have not
408 signed it. However, nothing else grants you permission to modify
409 or distribute the Library or its derivative works. These actions
410 are prohibited by law if you do not accept this License.
411 Therefore, by modifying or distributing the Library (or any work
412 based on the Library), you indicate your acceptance of this License
413 to do so, and all its terms and conditions for copying,
414 distributing or modifying the Library or works based on it.
416 10. Each time you redistribute the Library (or any work based on the
417 Library), the recipient automatically receives a license from the
418 original licensor to copy, distribute, link with or modify the
419 Library subject to these terms and conditions. You may not impose
420 any further restrictions on the recipients’ exercise of the rights
421 granted herein. You are not responsible for enforcing compliance
422 by third parties with this License.
424 11. If, as a consequence of a court judgment or allegation of patent
425 infringement or for any other reason (not limited to patent
426 issues), conditions are imposed on you (whether by court order,
427 agreement or otherwise) that contradict the conditions of this
428 License, they do not excuse you from the conditions of this
429 License. If you cannot distribute so as to satisfy simultaneously
430 your obligations under this License and any other pertinent
431 obligations, then as a consequence you may not distribute the
432 Library at all. For example, if a patent license would not permit
433 royalty-free redistribution of the Library by all those who receive
434 copies directly or indirectly through you, then the only way you
435 could satisfy both it and this License would be to refrain entirely
436 from distribution of the Library.
438 If any portion of this section is held invalid or unenforceable
439 under any particular circumstance, the balance of the section is
440 intended to apply, and the section as a whole is intended to apply
441 in other circumstances.
443 It is not the purpose of this section to induce you to infringe any
444 patents or other property right claims or to contest validity of
445 any such claims; this section has the sole purpose of protecting
446 the integrity of the free software distribution system which is
447 implemented by public license practices. Many people have made
448 generous contributions to the wide range of software distributed
449 through that system in reliance on consistent application of that
450 system; it is up to the author/donor to decide if he or she is
451 willing to distribute software through any other system and a
452 licensee cannot impose that choice.
454 This section is intended to make thoroughly clear what is believed
455 to be a consequence of the rest of this License.
457 12. If the distribution and/or use of the Library is restricted in
458 certain countries either by patents or by copyrighted interfaces,
459 the original copyright holder who places the Library under this
460 License may add an explicit geographical distribution limitation
461 excluding those countries, so that distribution is permitted only
462 in or among countries not thus excluded. In such case, this
463 License incorporates the limitation as if written in the body of
466 13. The Free Software Foundation may publish revised and/or new
467 versions of the Lesser General Public License from time to time.
468 Such new versions will be similar in spirit to the present version,
469 but may differ in detail to address new problems or concerns.
471 Each version is given a distinguishing version number. If the
472 Library specifies a version number of this License which applies to
473 it and “any later version”, you have the option of following the
474 terms and conditions either of that version or of any later version
475 published by the Free Software Foundation. If the Library does not
476 specify a license version number, you may choose any version ever
477 published by the Free Software Foundation.
479 14. If you wish to incorporate parts of the Library into other free
480 programs whose distribution conditions are incompatible with these,
481 write to the author to ask for permission. For software which is
482 copyrighted by the Free Software Foundation, write to the Free
483 Software Foundation; we sometimes make exceptions for this. Our
484 decision will be guided by the two goals of preserving the free
485 status of all derivatives of our free software and of promoting the
486 sharing and reuse of software generally.
490 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
491 WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE
492 LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS
493 AND/OR OTHER PARTIES PROVIDE THE LIBRARY “AS IS” WITHOUT WARRANTY
494 OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
495 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
496 FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
497 PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE
498 DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR
501 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
502 WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
503 MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE
504 LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
505 INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
506 INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF
507 DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU
508 OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY
509 OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
510 ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
512 END OF TERMS AND CONDITIONS
514 How to Apply These Terms to Your New Libraries
515 ==============================================
517 If you develop a new library, and you want it to be of the greatest
518 possible use to the public, we recommend making it free software that
519 everyone can redistribute and change. You can do so by permitting
520 redistribution under these terms (or, alternatively, under the terms of
521 the ordinary General Public License).
523 To apply these terms, attach the following notices to the library.
524 It is safest to attach them to the start of each source file to most
525 effectively convey the exclusion of warranty; and each file should have
526 at least the “copyright” line and a pointer to where the full notice is
529 ONE LINE TO GIVE THE LIBRARY'S NAME AND AN IDEA OF WHAT IT DOES.
530 Copyright (C) YEAR NAME OF AUTHOR
532 This library is free software; you can redistribute it and/or modify it
533 under the terms of the GNU Lesser General Public License as published by
534 the Free Software Foundation; either version 2.1 of the License, or (at
535 your option) any later version.
537 This library is distributed in the hope that it will be useful, but
538 WITHOUT ANY WARRANTY; without even the implied warranty of
539 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
540 Lesser General Public License for more details.
542 You should have received a copy of the GNU Lesser General Public
543 License along with this library; if not, write to the Free Software
544 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,
547 Also add information on how to contact you by electronic and paper
550 You should also get your employer (if you work as a programmer) or
551 your school, if any, to sign a “copyright disclaimer” for the library,
552 if necessary. Here is a sample; alter the names:
554 Yoyodyne, Inc., hereby disclaims all copyright interest in the library
555 `Frob' (a library for tweaking knobs) written by James Random Hacker.
557 SIGNATURE OF TY COON, 1 April 1990
558 Ty Coon, President of Vice
560 That’s all there is to it!
563 File: gpgme.info, Node: Copying, Next: Concept Index, Prev: Library Copying, Up: Top
565 GNU General Public License
566 **************************
568 Version 3, 29 June 2007
570 Copyright © 2007 Free Software Foundation, Inc. <https://fsf.org/>
572 Everyone is permitted to copy and distribute verbatim copies of this
573 license document, but changing it is not allowed.
578 The GNU General Public License is a free, copyleft license for software
579 and other kinds of works.
581 The licenses for most software and other practical works are designed
582 to take away your freedom to share and change the works. By contrast,
583 the GNU General Public License is intended to guarantee your freedom to
584 share and change all versions of a program–to make sure it remains free
585 software for all its users. We, the Free Software Foundation, use the
586 GNU General Public License for most of our software; it applies also to
587 any other work released this way by its authors. You can apply it to
590 When we speak of free software, we are referring to freedom, not
591 price. Our General Public Licenses are designed to make sure that you
592 have the freedom to distribute copies of free software (and charge for
593 them if you wish), that you receive source code or can get it if you
594 want it, that you can change the software or use pieces of it in new
595 free programs, and that you know you can do these things.
597 To protect your rights, we need to prevent others from denying you
598 these rights or asking you to surrender the rights. Therefore, you have
599 certain responsibilities if you distribute copies of the software, or if
600 you modify it: responsibilities to respect the freedom of others.
602 For example, if you distribute copies of such a program, whether
603 gratis or for a fee, you must pass on to the recipients the same
604 freedoms that you received. You must make sure that they, too, receive
605 or can get the source code. And you must show them these terms so they
608 Developers that use the GNU GPL protect your rights with two steps:
609 (1) assert copyright on the software, and (2) offer you this License
610 giving you legal permission to copy, distribute and/or modify it.
612 For the developers’ and authors’ protection, the GPL clearly explains
613 that there is no warranty for this free software. For both users’ and
614 authors’ sake, the GPL requires that modified versions be marked as
615 changed, so that their problems will not be attributed erroneously to
616 authors of previous versions.
618 Some devices are designed to deny users access to install or run
619 modified versions of the software inside them, although the manufacturer
620 can do so. This is fundamentally incompatible with the aim of
621 protecting users’ freedom to change the software. The systematic
622 pattern of such abuse occurs in the area of products for individuals to
623 use, which is precisely where it is most unacceptable. Therefore, we
624 have designed this version of the GPL to prohibit the practice for those
625 products. If such problems arise substantially in other domains, we
626 stand ready to extend this provision to those domains in future versions
627 of the GPL, as needed to protect the freedom of users.
629 Finally, every program is threatened constantly by software patents.
630 States should not allow patents to restrict development and use of
631 software on general-purpose computers, but in those that do, we wish to
632 avoid the special danger that patents applied to a free program could
633 make it effectively proprietary. To prevent this, the GPL assures that
634 patents cannot be used to render the program non-free.
636 The precise terms and conditions for copying, distribution and
643 “This License” refers to version 3 of the GNU General Public
646 “Copyright” also means copyright-like laws that apply to other
647 kinds of works, such as semiconductor masks.
649 “The Program” refers to any copyrightable work licensed under this
650 License. Each licensee is addressed as “you”. “Licensees” and
651 “recipients” may be individuals or organizations.
653 To “modify” a work means to copy from or adapt all or part of the
654 work in a fashion requiring copyright permission, other than the
655 making of an exact copy. The resulting work is called a “modified
656 version” of the earlier work or a work “based on” the earlier work.
658 A “covered work” means either the unmodified Program or a work
659 based on the Program.
661 To “propagate” a work means to do anything with it that, without
662 permission, would make you directly or secondarily liable for
663 infringement under applicable copyright law, except executing it on
664 a computer or modifying a private copy. Propagation includes
665 copying, distribution (with or without modification), making
666 available to the public, and in some countries other activities as
669 To “convey” a work means any kind of propagation that enables other
670 parties to make or receive copies. Mere interaction with a user
671 through a computer network, with no transfer of a copy, is not
674 An interactive user interface displays “Appropriate Legal Notices”
675 to the extent that it includes a convenient and prominently visible
676 feature that (1) displays an appropriate copyright notice, and (2)
677 tells the user that there is no warranty for the work (except to
678 the extent that warranties are provided), that licensees may convey
679 the work under this License, and how to view a copy of this
680 License. If the interface presents a list of user commands or
681 options, such as a menu, a prominent item in the list meets this
686 The “source code” for a work means the preferred form of the work
687 for making modifications to it. “Object code” means any non-source
690 A “Standard Interface” means an interface that either is an
691 official standard defined by a recognized standards body, or, in
692 the case of interfaces specified for a particular programming
693 language, one that is widely used among developers working in that
696 The “System Libraries” of an executable work include anything,
697 other than the work as a whole, that (a) is included in the normal
698 form of packaging a Major Component, but which is not part of that
699 Major Component, and (b) serves only to enable use of the work with
700 that Major Component, or to implement a Standard Interface for
701 which an implementation is available to the public in source code
702 form. A “Major Component”, in this context, means a major
703 essential component (kernel, window system, and so on) of the
704 specific operating system (if any) on which the executable work
705 runs, or a compiler used to produce the work, or an object code
706 interpreter used to run it.
708 The “Corresponding Source” for a work in object code form means all
709 the source code needed to generate, install, and (for an executable
710 work) run the object code and to modify the work, including scripts
711 to control those activities. However, it does not include the
712 work’s System Libraries, or general-purpose tools or generally
713 available free programs which are used unmodified in performing
714 those activities but which are not part of the work. For example,
715 Corresponding Source includes interface definition files associated
716 with source files for the work, and the source code for shared
717 libraries and dynamically linked subprograms that the work is
718 specifically designed to require, such as by intimate data
719 communication or control flow between those subprograms and other
722 The Corresponding Source need not include anything that users can
723 regenerate automatically from other parts of the Corresponding
726 The Corresponding Source for a work in source code form is that
729 2. Basic Permissions.
731 All rights granted under this License are granted for the term of
732 copyright on the Program, and are irrevocable provided the stated
733 conditions are met. This License explicitly affirms your unlimited
734 permission to run the unmodified Program. The output from running
735 a covered work is covered by this License only if the output, given
736 its content, constitutes a covered work. This License acknowledges
737 your rights of fair use or other equivalent, as provided by
740 You may make, run and propagate covered works that you do not
741 convey, without conditions so long as your license otherwise
742 remains in force. You may convey covered works to others for the
743 sole purpose of having them make modifications exclusively for you,
744 or provide you with facilities for running those works, provided
745 that you comply with the terms of this License in conveying all
746 material for which you do not control copyright. Those thus making
747 or running the covered works for you must do so exclusively on your
748 behalf, under your direction and control, on terms that prohibit
749 them from making any copies of your copyrighted material outside
750 their relationship with you.
752 Conveying under any other circumstances is permitted solely under
753 the conditions stated below. Sublicensing is not allowed; section
754 10 makes it unnecessary.
756 3. Protecting Users’ Legal Rights From Anti-Circumvention Law.
758 No covered work shall be deemed part of an effective technological
759 measure under any applicable law fulfilling obligations under
760 article 11 of the WIPO copyright treaty adopted on 20 December
761 1996, or similar laws prohibiting or restricting circumvention of
764 When you convey a covered work, you waive any legal power to forbid
765 circumvention of technological measures to the extent such
766 circumvention is effected by exercising rights under this License
767 with respect to the covered work, and you disclaim any intention to
768 limit operation or modification of the work as a means of
769 enforcing, against the work’s users, your or third parties’ legal
770 rights to forbid circumvention of technological measures.
772 4. Conveying Verbatim Copies.
774 You may convey verbatim copies of the Program’s source code as you
775 receive it, in any medium, provided that you conspicuously and
776 appropriately publish on each copy an appropriate copyright notice;
777 keep intact all notices stating that this License and any
778 non-permissive terms added in accord with section 7 apply to the
779 code; keep intact all notices of the absence of any warranty; and
780 give all recipients a copy of this License along with the Program.
782 You may charge any price or no price for each copy that you convey,
783 and you may offer support or warranty protection for a fee.
785 5. Conveying Modified Source Versions.
787 You may convey a work based on the Program, or the modifications to
788 produce it from the Program, in the form of source code under the
789 terms of section 4, provided that you also meet all of these
792 a. The work must carry prominent notices stating that you
793 modified it, and giving a relevant date.
795 b. The work must carry prominent notices stating that it is
796 released under this License and any conditions added under
797 section 7. This requirement modifies the requirement in
798 section 4 to “keep intact all notices”.
800 c. You must license the entire work, as a whole, under this
801 License to anyone who comes into possession of a copy. This
802 License will therefore apply, along with any applicable
803 section 7 additional terms, to the whole of the work, and all
804 its parts, regardless of how they are packaged. This License
805 gives no permission to license the work in any other way, but
806 it does not invalidate such permission if you have separately
809 d. If the work has interactive user interfaces, each must display
810 Appropriate Legal Notices; however, if the Program has
811 interactive interfaces that do not display Appropriate Legal
812 Notices, your work need not make them do so.
814 A compilation of a covered work with other separate and independent
815 works, which are not by their nature extensions of the covered
816 work, and which are not combined with it such as to form a larger
817 program, in or on a volume of a storage or distribution medium, is
818 called an “aggregate” if the compilation and its resulting
819 copyright are not used to limit the access or legal rights of the
820 compilation’s users beyond what the individual works permit.
821 Inclusion of a covered work in an aggregate does not cause this
822 License to apply to the other parts of the aggregate.
824 6. Conveying Non-Source Forms.
826 You may convey a covered work in object code form under the terms
827 of sections 4 and 5, provided that you also convey the
828 machine-readable Corresponding Source under the terms of this
829 License, in one of these ways:
831 a. Convey the object code in, or embodied in, a physical product
832 (including a physical distribution medium), accompanied by the
833 Corresponding Source fixed on a durable physical medium
834 customarily used for software interchange.
836 b. Convey the object code in, or embodied in, a physical product
837 (including a physical distribution medium), accompanied by a
838 written offer, valid for at least three years and valid for as
839 long as you offer spare parts or customer support for that
840 product model, to give anyone who possesses the object code
841 either (1) a copy of the Corresponding Source for all the
842 software in the product that is covered by this License, on a
843 durable physical medium customarily used for software
844 interchange, for a price no more than your reasonable cost of
845 physically performing this conveying of source, or (2) access
846 to copy the Corresponding Source from a network server at no
849 c. Convey individual copies of the object code with a copy of the
850 written offer to provide the Corresponding Source. This
851 alternative is allowed only occasionally and noncommercially,
852 and only if you received the object code with such an offer,
853 in accord with subsection 6b.
855 d. Convey the object code by offering access from a designated
856 place (gratis or for a charge), and offer equivalent access to
857 the Corresponding Source in the same way through the same
858 place at no further charge. You need not require recipients
859 to copy the Corresponding Source along with the object code.
860 If the place to copy the object code is a network server, the
861 Corresponding Source may be on a different server (operated by
862 you or a third party) that supports equivalent copying
863 facilities, provided you maintain clear directions next to the
864 object code saying where to find the Corresponding Source.
865 Regardless of what server hosts the Corresponding Source, you
866 remain obligated to ensure that it is available for as long as
867 needed to satisfy these requirements.
869 e. Convey the object code using peer-to-peer transmission,
870 provided you inform other peers where the object code and
871 Corresponding Source of the work are being offered to the
872 general public at no charge under subsection 6d.
874 A separable portion of the object code, whose source code is
875 excluded from the Corresponding Source as a System Library, need
876 not be included in conveying the object code work.
878 A “User Product” is either (1) a “consumer product”, which means
879 any tangible personal property which is normally used for personal,
880 family, or household purposes, or (2) anything designed or sold for
881 incorporation into a dwelling. In determining whether a product is
882 a consumer product, doubtful cases shall be resolved in favor of
883 coverage. For a particular product received by a particular user,
884 “normally used” refers to a typical or common use of that class of
885 product, regardless of the status of the particular user or of the
886 way in which the particular user actually uses, or expects or is
887 expected to use, the product. A product is a consumer product
888 regardless of whether the product has substantial commercial,
889 industrial or non-consumer uses, unless such uses represent the
890 only significant mode of use of the product.
892 “Installation Information” for a User Product means any methods,
893 procedures, authorization keys, or other information required to
894 install and execute modified versions of a covered work in that
895 User Product from a modified version of its Corresponding Source.
896 The information must suffice to ensure that the continued
897 functioning of the modified object code is in no case prevented or
898 interfered with solely because modification has been made.
900 If you convey an object code work under this section in, or with,
901 or specifically for use in, a User Product, and the conveying
902 occurs as part of a transaction in which the right of possession
903 and use of the User Product is transferred to the recipient in
904 perpetuity or for a fixed term (regardless of how the transaction
905 is characterized), the Corresponding Source conveyed under this
906 section must be accompanied by the Installation Information. But
907 this requirement does not apply if neither you nor any third party
908 retains the ability to install modified object code on the User
909 Product (for example, the work has been installed in ROM).
911 The requirement to provide Installation Information does not
912 include a requirement to continue to provide support service,
913 warranty, or updates for a work that has been modified or installed
914 by the recipient, or for the User Product in which it has been
915 modified or installed. Access to a network may be denied when the
916 modification itself materially and adversely affects the operation
917 of the network or violates the rules and protocols for
918 communication across the network.
920 Corresponding Source conveyed, and Installation Information
921 provided, in accord with this section must be in a format that is
922 publicly documented (and with an implementation available to the
923 public in source code form), and must require no special password
924 or key for unpacking, reading or copying.
928 “Additional permissions” are terms that supplement the terms of
929 this License by making exceptions from one or more of its
930 conditions. Additional permissions that are applicable to the
931 entire Program shall be treated as though they were included in
932 this License, to the extent that they are valid under applicable
933 law. If additional permissions apply only to part of the Program,
934 that part may be used separately under those permissions, but the
935 entire Program remains governed by this License without regard to
936 the additional permissions.
938 When you convey a copy of a covered work, you may at your option
939 remove any additional permissions from that copy, or from any part
940 of it. (Additional permissions may be written to require their own
941 removal in certain cases when you modify the work.) You may place
942 additional permissions on material, added by you to a covered work,
943 for which you have or can give appropriate copyright permission.
945 Notwithstanding any other provision of this License, for material
946 you add to a covered work, you may (if authorized by the copyright
947 holders of that material) supplement the terms of this License with
950 a. Disclaiming warranty or limiting liability differently from
951 the terms of sections 15 and 16 of this License; or
953 b. Requiring preservation of specified reasonable legal notices
954 or author attributions in that material or in the Appropriate
955 Legal Notices displayed by works containing it; or
957 c. Prohibiting misrepresentation of the origin of that material,
958 or requiring that modified versions of such material be marked
959 in reasonable ways as different from the original version; or
961 d. Limiting the use for publicity purposes of names of licensors
962 or authors of the material; or
964 e. Declining to grant rights under trademark law for use of some
965 trade names, trademarks, or service marks; or
967 f. Requiring indemnification of licensors and authors of that
968 material by anyone who conveys the material (or modified
969 versions of it) with contractual assumptions of liability to
970 the recipient, for any liability that these contractual
971 assumptions directly impose on those licensors and authors.
973 All other non-permissive additional terms are considered “further
974 restrictions” within the meaning of section 10. If the Program as
975 you received it, or any part of it, contains a notice stating that
976 it is governed by this License along with a term that is a further
977 restriction, you may remove that term. If a license document
978 contains a further restriction but permits relicensing or conveying
979 under this License, you may add to a covered work material governed
980 by the terms of that license document, provided that the further
981 restriction does not survive such relicensing or conveying.
983 If you add terms to a covered work in accord with this section, you
984 must place, in the relevant source files, a statement of the
985 additional terms that apply to those files, or a notice indicating
986 where to find the applicable terms.
988 Additional terms, permissive or non-permissive, may be stated in
989 the form of a separately written license, or stated as exceptions;
990 the above requirements apply either way.
994 You may not propagate or modify a covered work except as expressly
995 provided under this License. Any attempt otherwise to propagate or
996 modify it is void, and will automatically terminate your rights
997 under this License (including any patent licenses granted under the
998 third paragraph of section 11).
1000 However, if you cease all violation of this License, then your
1001 license from a particular copyright holder is reinstated (a)
1002 provisionally, unless and until the copyright holder explicitly and
1003 finally terminates your license, and (b) permanently, if the
1004 copyright holder fails to notify you of the violation by some
1005 reasonable means prior to 60 days after the cessation.
1007 Moreover, your license from a particular copyright holder is
1008 reinstated permanently if the copyright holder notifies you of the
1009 violation by some reasonable means, this is the first time you have
1010 received notice of violation of this License (for any work) from
1011 that copyright holder, and you cure the violation prior to 30 days
1012 after your receipt of the notice.
1014 Termination of your rights under this section does not terminate
1015 the licenses of parties who have received copies or rights from you
1016 under this License. If your rights have been terminated and not
1017 permanently reinstated, you do not qualify to receive new licenses
1018 for the same material under section 10.
1020 9. Acceptance Not Required for Having Copies.
1022 You are not required to accept this License in order to receive or
1023 run a copy of the Program. Ancillary propagation of a covered work
1024 occurring solely as a consequence of using peer-to-peer
1025 transmission to receive a copy likewise does not require
1026 acceptance. However, nothing other than this License grants you
1027 permission to propagate or modify any covered work. These actions
1028 infringe copyright if you do not accept this License. Therefore,
1029 by modifying or propagating a covered work, you indicate your
1030 acceptance of this License to do so.
1032 10. Automatic Licensing of Downstream Recipients.
1034 Each time you convey a covered work, the recipient automatically
1035 receives a license from the original licensors, to run, modify and
1036 propagate that work, subject to this License. You are not
1037 responsible for enforcing compliance by third parties with this
1040 An “entity transaction” is a transaction transferring control of an
1041 organization, or substantially all assets of one, or subdividing an
1042 organization, or merging organizations. If propagation of a
1043 covered work results from an entity transaction, each party to that
1044 transaction who receives a copy of the work also receives whatever
1045 licenses to the work the party’s predecessor in interest had or
1046 could give under the previous paragraph, plus a right to possession
1047 of the Corresponding Source of the work from the predecessor in
1048 interest, if the predecessor has it or can get it with reasonable
1051 You may not impose any further restrictions on the exercise of the
1052 rights granted or affirmed under this License. For example, you
1053 may not impose a license fee, royalty, or other charge for exercise
1054 of rights granted under this License, and you may not initiate
1055 litigation (including a cross-claim or counterclaim in a lawsuit)
1056 alleging that any patent claim is infringed by making, using,
1057 selling, offering for sale, or importing the Program or any portion
1062 A “contributor” is a copyright holder who authorizes use under this
1063 License of the Program or a work on which the Program is based.
1064 The work thus licensed is called the contributor’s “contributor
1067 A contributor’s “essential patent claims” are all patent claims
1068 owned or controlled by the contributor, whether already acquired or
1069 hereafter acquired, that would be infringed by some manner,
1070 permitted by this License, of making, using, or selling its
1071 contributor version, but do not include claims that would be
1072 infringed only as a consequence of further modification of the
1073 contributor version. For purposes of this definition, “control”
1074 includes the right to grant patent sublicenses in a manner
1075 consistent with the requirements of this License.
1077 Each contributor grants you a non-exclusive, worldwide,
1078 royalty-free patent license under the contributor’s essential
1079 patent claims, to make, use, sell, offer for sale, import and
1080 otherwise run, modify and propagate the contents of its contributor
1083 In the following three paragraphs, a “patent license” is any
1084 express agreement or commitment, however denominated, not to
1085 enforce a patent (such as an express permission to practice a
1086 patent or covenant not to sue for patent infringement). To “grant”
1087 such a patent license to a party means to make such an agreement or
1088 commitment not to enforce a patent against the party.
1090 If you convey a covered work, knowingly relying on a patent
1091 license, and the Corresponding Source of the work is not available
1092 for anyone to copy, free of charge and under the terms of this
1093 License, through a publicly available network server or other
1094 readily accessible means, then you must either (1) cause the
1095 Corresponding Source to be so available, or (2) arrange to deprive
1096 yourself of the benefit of the patent license for this particular
1097 work, or (3) arrange, in a manner consistent with the requirements
1098 of this License, to extend the patent license to downstream
1099 recipients. “Knowingly relying” means you have actual knowledge
1100 that, but for the patent license, your conveying the covered work
1101 in a country, or your recipient’s use of the covered work in a
1102 country, would infringe one or more identifiable patents in that
1103 country that you have reason to believe are valid.
1105 If, pursuant to or in connection with a single transaction or
1106 arrangement, you convey, or propagate by procuring conveyance of, a
1107 covered work, and grant a patent license to some of the parties
1108 receiving the covered work authorizing them to use, propagate,
1109 modify or convey a specific copy of the covered work, then the
1110 patent license you grant is automatically extended to all
1111 recipients of the covered work and works based on it.
1113 A patent license is “discriminatory” if it does not include within
1114 the scope of its coverage, prohibits the exercise of, or is
1115 conditioned on the non-exercise of one or more of the rights that
1116 are specifically granted under this License. You may not convey a
1117 covered work if you are a party to an arrangement with a third
1118 party that is in the business of distributing software, under which
1119 you make payment to the third party based on the extent of your
1120 activity of conveying the work, and under which the third party
1121 grants, to any of the parties who would receive the covered work
1122 from you, a discriminatory patent license (a) in connection with
1123 copies of the covered work conveyed by you (or copies made from
1124 those copies), or (b) primarily for and in connection with specific
1125 products or compilations that contain the covered work, unless you
1126 entered into that arrangement, or that patent license was granted,
1127 prior to 28 March 2007.
1129 Nothing in this License shall be construed as excluding or limiting
1130 any implied license or other defenses to infringement that may
1131 otherwise be available to you under applicable patent law.
1133 12. No Surrender of Others’ Freedom.
1135 If conditions are imposed on you (whether by court order, agreement
1136 or otherwise) that contradict the conditions of this License, they
1137 do not excuse you from the conditions of this License. If you
1138 cannot convey a covered work so as to satisfy simultaneously your
1139 obligations under this License and any other pertinent obligations,
1140 then as a consequence you may not convey it at all. For example,
1141 if you agree to terms that obligate you to collect a royalty for
1142 further conveying from those to whom you convey the Program, the
1143 only way you could satisfy both those terms and this License would
1144 be to refrain entirely from conveying the Program.
1146 13. Use with the GNU Affero General Public License.
1148 Notwithstanding any other provision of this License, you have
1149 permission to link or combine any covered work with a work licensed
1150 under version 3 of the GNU Affero General Public License into a
1151 single combined work, and to convey the resulting work. The terms
1152 of this License will continue to apply to the part which is the
1153 covered work, but the special requirements of the GNU Affero
1154 General Public License, section 13, concerning interaction through
1155 a network will apply to the combination as such.
1157 14. Revised Versions of this License.
1159 The Free Software Foundation may publish revised and/or new
1160 versions of the GNU General Public License from time to time. Such
1161 new versions will be similar in spirit to the present version, but
1162 may differ in detail to address new problems or concerns.
1164 Each version is given a distinguishing version number. If the
1165 Program specifies that a certain numbered version of the GNU
1166 General Public License “or any later version” applies to it, you
1167 have the option of following the terms and conditions either of
1168 that numbered version or of any later version published by the Free
1169 Software Foundation. If the Program does not specify a version
1170 number of the GNU General Public License, you may choose any
1171 version ever published by the Free Software Foundation.
1173 If the Program specifies that a proxy can decide which future
1174 versions of the GNU General Public License can be used, that
1175 proxy’s public statement of acceptance of a version permanently
1176 authorizes you to choose that version for the Program.
1178 Later license versions may give you additional or different
1179 permissions. However, no additional obligations are imposed on any
1180 author or copyright holder as a result of your choosing to follow a
1183 15. Disclaimer of Warranty.
1185 THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
1186 APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
1187 COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS”
1188 WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
1189 INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
1190 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
1191 RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
1192 SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
1193 NECESSARY SERVICING, REPAIR OR CORRECTION.
1195 16. Limitation of Liability.
1197 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
1198 WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES
1199 AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
1200 DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
1201 CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
1202 THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
1203 BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
1204 PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
1205 PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF
1206 THE POSSIBILITY OF SUCH DAMAGES.
1208 17. Interpretation of Sections 15 and 16.
1210 If the disclaimer of warranty and limitation of liability provided
1211 above cannot be given local legal effect according to their terms,
1212 reviewing courts shall apply local law that most closely
1213 approximates an absolute waiver of all civil liability in
1214 connection with the Program, unless a warranty or assumption of
1215 liability accompanies a copy of the Program in return for a fee.
1217 END OF TERMS AND CONDITIONS
1219 How to Apply These Terms to Your New Programs
1220 =============================================
1222 If you develop a new program, and you want it to be of the greatest
1223 possible use to the public, the best way to achieve this is to make it
1224 free software which everyone can redistribute and change under these
1227 To do so, attach the following notices to the program. It is safest
1228 to attach them to the start of each source file to most effectively
1229 state the exclusion of warranty; and each file should have at least the
1230 “copyright” line and a pointer to where the full notice is found.
1232 ONE LINE TO GIVE THE PROGRAM'S NAME AND A BRIEF IDEA OF WHAT IT DOES.
1233 Copyright (C) YEAR NAME OF AUTHOR
1235 This program is free software: you can redistribute it and/or modify
1236 it under the terms of the GNU General Public License as published by
1237 the Free Software Foundation, either version 3 of the License, or (at
1238 your option) any later version.
1240 This program is distributed in the hope that it will be useful, but
1241 WITHOUT ANY WARRANTY; without even the implied warranty of
1242 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1243 General Public License for more details.
1245 You should have received a copy of the GNU General Public License
1246 along with this program. If not, see <https://www.gnu.org/licenses/>.
1248 Also add information on how to contact you by electronic and paper mail.
1250 If the program does terminal interaction, make it output a short notice
1251 like this when it starts in an interactive mode:
1253 PROGRAM Copyright (C) YEAR NAME OF AUTHOR
1254 This program comes with ABSOLUTELY NO WARRANTY; for details
1255 type ‘show w’. This is free software, and you are
1256 welcome to redistribute it under certain conditions;
1257 type ‘show c’ for details.
1259 The hypothetical commands ‘show w’ and ‘show c’ should show the
1260 appropriate parts of the General Public License. Of course, your
1261 program’s commands might be different; for a GUI interface, you would
1264 You should also get your employer (if you work as a programmer) or
1265 school, if any, to sign a “copyright disclaimer” for the program, if
1266 necessary. For more information on this, and how to apply and follow
1267 the GNU GPL, see <https://www.gnu.org/licenses/>.
1269 The GNU General Public License does not permit incorporating your
1270 program into proprietary programs. If your program is a subroutine
1271 library, you may consider it more useful to permit linking proprietary
1272 applications with the library. If this is what you want to do, use the
1273 GNU Lesser General Public License instead of this License. But first,
1274 please read <https://www.gnu.org/philosophy/why-not-lgpl.html>.
1277 File: gpgme.info, Node: Concept Index, Next: Function and Data Index, Prev: Copying, Up: Top
1285 * aborting operations: Cancellation. (line 6)
1286 * algorithms: Algorithms. (line 6)
1287 * algorithms, hash: Hash Algorithms. (line 6)
1288 * algorithms, message digest: Hash Algorithms. (line 6)
1289 * algorithms, public key: Public Key Algorithms. (line 6)
1290 * armor mode: ASCII Armor. (line 6)
1291 * ASCII armor: ASCII Armor. (line 6)
1292 * ASSUAN: Assuan. (line 6)
1293 * attributes, of a key: Information About Keys.
1295 * autoconf: Using Automake. (line 6)
1296 * automake: Using Automake. (line 6)
1297 * backend: Protocols and Engines. (line 6)
1298 * callback, passphrase: Passphrase Callback. (line 6)
1299 * callback, progress meter: Progress Meter Callback.
1301 * callback, status message: Status Message Callback.
1303 * cancelling operations: Cancellation. (line 6)
1304 * canonical text mode: Text Mode. (line 6)
1305 * certificates, included: Included Certificates. (line 6)
1306 * CMS: Cryptographic Message Syntax.
1308 * compiler flags: Building the Source. (line 6)
1309 * compiler options: Building the Source. (line 6)
1310 * configuration of crypto backend: Engine Configuration. (line 6)
1311 * context: Contexts. (line 6)
1312 * context, armor mode: ASCII Armor. (line 6)
1313 * context, attributes: Context Attributes. (line 6)
1314 * context, configuring engine: Crypto Engine. (line 6)
1315 * context, creation: Creating Contexts. (line 6)
1316 * context, destruction: Destroying Contexts. (line 6)
1317 * context, offline mode: Offline Mode. (line 6)
1318 * context, pinentry mode: Pinentry Mode. (line 6)
1319 * context, result of operation: Result Management. (line 6)
1320 * context, selecting protocol: Protocol Selection. (line 6)
1321 * context, sender: Setting the Sender. (line 6)
1322 * context, text mode: Text Mode. (line 6)
1323 * crypto backend: Protocols and Engines. (line 6)
1324 * crypto engine: Protocols and Engines. (line 6)
1325 * cryptographic message syntax: Cryptographic Message Syntax.
1327 * cryptographic operation: Crypto Operations. (line 6)
1328 * cryptographic operation, aborting: Cancellation. (line 6)
1329 * cryptographic operation, cancelling: Cancellation. (line 6)
1330 * cryptographic operation, decryption: Decrypt. (line 6)
1331 * cryptographic operation, decryption and verification: Decrypt and Verify.
1333 * cryptographic operation, encryption: Encrypt. (line 6)
1334 * cryptographic operation, running: Run Control. (line 6)
1335 * cryptographic operation, signature check: Verify. (line 6)
1336 * cryptographic operation, signing: Sign. (line 6)
1337 * cryptographic operation, verification: Verify. (line 6)
1338 * cryptographic operation, wait for: Waiting For Completion.
1340 * data buffer, convenience: Data Buffer Convenience.
1342 * data buffer, creation: Creating Data Buffers. (line 6)
1343 * data buffer, destruction: Destroying Data Buffers.
1345 * data buffer, encoding: Data Buffer Meta-Data. (line 6)
1346 * data buffer, file name: Data Buffer Meta-Data. (line 6)
1347 * data buffer, I/O operations: Data Buffer I/O Operations.
1349 * data buffer, manipulation: Manipulating Data Buffers.
1351 * data buffer, meta-data: Data Buffer Meta-Data. (line 6)
1352 * data buffer, read: Data Buffer I/O Operations.
1354 * data buffer, seek: Data Buffer I/O Operations.
1356 * data buffer, write: Data Buffer I/O Operations.
1358 * data, exchanging: Exchanging Data. (line 6)
1359 * debug: Debugging. (line 6)
1360 * decryption: Decrypt. (line 6)
1361 * decryption and verification: Decrypt and Verify. (line 6)
1362 * deprecated: Deprecated Functions. (line 6)
1363 * encryption: Encrypt. (line 6)
1364 * engine: Protocols and Engines. (line 6)
1365 * engine, ASSUAN: Assuan. (line 6)
1366 * engine, configuration of: Engine Configuration. (line 6)
1367 * engine, configuration per context: Crypto Engine. (line 6)
1368 * engine, GnuPG: OpenPGP. (line 6)
1369 * engine, GpgSM: Cryptographic Message Syntax.
1371 * engine, information about: Engine Information. (line 6)
1372 * error codes: Error Values. (line 6)
1373 * error codes, list of: Error Sources. (line 6)
1374 * error codes, list of <1>: Error Codes. (line 6)
1375 * error codes, printing of: Error Strings. (line 6)
1376 * error handling: Error Handling. (line 6)
1377 * error sources: Error Values. (line 6)
1378 * error sources, printing of: Error Strings. (line 6)
1379 * error strings: Error Strings. (line 6)
1380 * error values: Error Values. (line 6)
1381 * error values, printing of: Error Strings. (line 6)
1382 * event loop, external: Using External Event Loops.
1384 * From:: Setting the Sender. (line 6)
1385 * GDK, using GPGME with: I/O Callback Example GDK.
1387 * GnuPG: OpenPGP. (line 6)
1388 * GPGME_DEBUG: Debugging. (line 6)
1389 * GpgSM: Cryptographic Message Syntax.
1391 * GTK+, using GPGME with: I/O Callback Example GTK+.
1393 * hash algorithms: Hash Algorithms. (line 6)
1394 * header file: Header. (line 6)
1395 * identify: Data Buffer Convenience.
1397 * include file: Header. (line 6)
1398 * key listing: Listing Keys. (line 6)
1399 * key listing mode: Key Listing Mode. (line 6)
1400 * key listing, mode of: Key Listing Mode. (line 6)
1401 * key listing, start: Listing Keys. (line 6)
1402 * key management: Key Management. (line 6)
1403 * key ring, add: Generating Keys. (line 6)
1404 * key ring, delete from: Deleting Keys. (line 6)
1405 * key ring, export from: Exporting Keys. (line 6)
1406 * key ring, import to: Importing Keys. (line 6)
1407 * key ring, list: Listing Keys. (line 6)
1408 * key ring, search: Listing Keys. (line 6)
1409 * key, attributes: Information About Keys.
1411 * key, creation: Generating Keys. (line 6)
1412 * key, delete: Deleting Keys. (line 6)
1413 * key, edit: Advanced Key Editing. (line 6)
1414 * key, export: Exporting Keys. (line 6)
1415 * key, import: Importing Keys. (line 6)
1416 * key, information about: Information About Keys.
1418 * key, manipulation: Manipulating Keys. (line 6)
1419 * key, signing: Signing Keys. (line 6)
1420 * largefile support: Largefile Support (LFS).
1422 * LFS: Largefile Support (LFS).
1424 * LGPL, GNU Lesser General Public License: Library Copying. (line 6)
1425 * libtool: Using Libtool. (line 6)
1426 * listing keys: Listing Keys. (line 6)
1427 * locale, default: Locale. (line 6)
1428 * locale, of a context: Locale. (line 6)
1429 * message digest algorithms: Hash Algorithms. (line 6)
1430 * multi-threading: Multi-Threading. (line 6)
1431 * notation data: Verify. (line 6)
1432 * notation data <1>: Signature Notation Data.
1434 * offline mode: Offline Mode. (line 6)
1435 * OpenPGP: OpenPGP. (line 6)
1436 * passphrase callback: Passphrase Callback. (line 6)
1437 * passphrase, change: Changing Passphrases. (line 6)
1438 * pinentry mode: Pinentry Mode. (line 6)
1439 * policy URL: Signature Notation Data.
1441 * progress meter callback: Progress Meter Callback.
1443 * protocol: Protocols and Engines. (line 6)
1444 * protocol, ASSUAN: Assuan. (line 6)
1445 * protocol, CMS: Cryptographic Message Syntax.
1447 * protocol, GnuPG: OpenPGP. (line 6)
1448 * protocol, S/MIME: Cryptographic Message Syntax.
1450 * protocol, selecting: Protocol Selection. (line 6)
1451 * public key algorithms: Public Key Algorithms. (line 6)
1452 * Qt, using GPGME with: I/O Callback Example Qt.
1454 * run control: Run Control. (line 6)
1455 * S/MIME: Cryptographic Message Syntax.
1457 * sender: Setting the Sender. (line 6)
1458 * sign: Sign. (line 6)
1459 * signal handling: Signal Handling. (line 6)
1460 * signals: Signal Handling. (line 6)
1461 * signature check: Decrypt and Verify. (line 6)
1462 * signature notation data: Verify. (line 6)
1463 * signature notation data <1>: Signature Notation Data.
1465 * signature, creation: Sign. (line 6)
1466 * signature, selecting signers: Selecting Signers. (line 6)
1467 * signature, verification: Verify. (line 6)
1468 * signers, selecting: Selecting Signers. (line 6)
1469 * status message callback: Status Message Callback.
1471 * text mode: Text Mode. (line 6)
1472 * thread-safeness: Multi-Threading. (line 6)
1473 * trust item: Trust Item Management. (line 6)
1474 * trust item list: Listing Trust Items. (line 6)
1475 * trust item, manipulation: Manipulating Trust Items.
1477 * type of data: Data Buffer Convenience.
1479 * UI server: UI Server Protocol. (line 6)
1480 * user interface server: UI Server Protocol. (line 6)
1481 * validity, TOFU: Changing TOFU Data. (line 6)
1482 * verification: Verify. (line 6)
1483 * verification and decryption: Decrypt and Verify. (line 6)
1484 * version check, of the engines: Engine Version Check. (line 6)
1485 * version check, of the library: Library Version Check. (line 6)
1486 * wait for completion: Waiting For Completion.
1490 File: gpgme.info, Node: Function and Data Index, Prev: Concept Index, Up: Top
1492 Function and Data Index
1493 ***********************
1498 * AM_PATH_GPGME: Using Automake. (line 11)
1499 * AM_PATH_GPGME_PTH: Using Automake. (line 13)
1500 * AM_PATH_GPGME_PTHREAD: Using Automake. (line 15)
1501 * CHECKSUM_CREATE_FILES: UI Server Checksum Files.
1503 * CHECKSUM_VERIFY_FILES: UI Server Checksum Files.
1505 * DECRYPT: UI Server Decrypt. (line 26)
1506 * DECRYPT_FILES: UI Server Verify/Decrypt Files.
1508 * DECRYPT_VERIFY_FILES: UI Server Verify/Decrypt Files.
1510 * ENCRYPT: UI Server Encrypt. (line 47)
1511 * ENCRYPT_FILES: UI Server Sign/Encrypt Files.
1513 * ENCRYPT_SIGN_FILES: UI Server Sign/Encrypt Files.
1515 * enum gpgme_data_encoding_t: Data Buffer Meta-Data.
1517 * enum gpgme_data_type_t: Data Buffer Convenience.
1519 * enum gpgme_event_io_t: I/O Callback Interface.
1521 * enum gpgme_hash_algo_t: Hash Algorithms. (line 9)
1522 * enum gpgme_pinentry_mode_t: Pinentry Mode. (line 19)
1523 * enum gpgme_protocol_t: Protocols and Engines.
1525 * enum gpgme_pubkey_algo_t: Public Key Algorithms.
1527 * enum gpgme_sig_mode_t: Creating a Signature.
1529 * enum gpgme_sig_stat_t: Deprecated Functions.
1531 * enum gpgme_tofu_policy_t: Changing TOFU Data. (line 10)
1532 * FILE: UI Server Set Input Files.
1534 * GETINFO: Miscellaneous UI Server Commands.
1536 * gpgme_addrspec_from_uid: Decrypt and Verify. (line 47)
1537 * gpgme_attr_t: Deprecated Functions.
1539 * gpgme_attr_t <1>: Deprecated Functions.
1541 * gpgme_cancel: Cancellation. (line 16)
1542 * gpgme_cancel_async: Cancellation. (line 36)
1543 * gpgme_check_version: Library Version Check.
1545 * gpgme_ctx_get_engine_info: Crypto Engine. (line 12)
1546 * gpgme_ctx_set_engine_info: Crypto Engine. (line 24)
1547 * gpgme_ctx_t: Contexts. (line 11)
1548 * gpgme_data_encoding_t: Data Buffer Meta-Data.
1550 * gpgme_data_get_encoding: Data Buffer Meta-Data.
1552 * gpgme_data_get_file_name: Data Buffer Meta-Data.
1554 * gpgme_data_identify: Data Buffer Convenience.
1556 * gpgme_data_new: Memory Based Data Buffers.
1558 * gpgme_data_new_from_cbs: Callback Based Data Buffers.
1560 * gpgme_data_new_from_fd: File Based Data Buffers.
1562 * gpgme_data_new_from_file: Memory Based Data Buffers.
1564 * gpgme_data_new_from_filepart: Memory Based Data Buffers.
1566 * gpgme_data_new_from_mem: Memory Based Data Buffers.
1568 * gpgme_data_new_from_stream: File Based Data Buffers.
1570 * gpgme_data_new_with_read_cb: Deprecated Functions.
1572 * gpgme_data_read: Data Buffer I/O Operations.
1574 * gpgme_data_read_cb_t: Callback Based Data Buffers.
1576 * gpgme_data_release: Destroying Data Buffers.
1578 * gpgme_data_release_and_get_mem: Destroying Data Buffers.
1580 * gpgme_data_release_cb_t: Callback Based Data Buffers.
1582 * gpgme_data_rewind: Deprecated Functions.
1584 * gpgme_data_seek: Data Buffer I/O Operations.
1586 * gpgme_data_seek_cb_t: Callback Based Data Buffers.
1588 * gpgme_data_set_encoding: Data Buffer Meta-Data.
1590 * gpgme_data_set_file_name: Data Buffer Meta-Data.
1592 * gpgme_data_set_flag: Data Buffer Meta-Data.
1594 * gpgme_data_t: Exchanging Data. (line 13)
1595 * gpgme_data_type_t: Data Buffer Convenience.
1597 * gpgme_data_write: Data Buffer I/O Operations.
1599 * gpgme_data_write_cb_t: Callback Based Data Buffers.
1601 * gpgme_decrypt_result_t: Decrypt. (line 54)
1602 * gpgme_edit_cb_t: Deprecated Functions.
1604 * gpgme_encrypt_result_t: Encrypting a Plaintext.
1606 * gpgme_engine_check_version: Engine Version Check.
1608 * gpgme_engine_info_t: Engine Information. (line 6)
1609 * gpgme_error: Error Values. (line 65)
1610 * gpgme_error_from_errno: Error Values. (line 88)
1611 * gpgme_error_t: Error Values. (line 24)
1612 * gpgme_error_t (*gpgme_assuan_data_cb_t) (void *OPAQUE, const void *DATA, size_t DATALEN): Using the Assuan protocol.
1614 * gpgme_error_t (*gpgme_assuan_inquire_cb_t) (void *OPAQUE, const char *NAME, const char *ARGS, gpgme_data_t *R_DATA): Using the Assuan protocol.
1616 * gpgme_error_t (*gpgme_assuan_status_cb_t) (void *OPAQUE, const char *STATUS, const char *ARGS): Using the Assuan protocol.
1618 * gpgme_error_t (*gpgme_edit_cb_t) (void *HANDLE, gpgme_status_code_t STATUS, const char *ARGS, int FD): Deprecated Functions.
1620 * gpgme_error_t (*gpgme_interact_cb_t) (void *HANDLE, const char *STATUS, const char *ARGS, int FD): Advanced Key Editing.
1622 * gpgme_error_t (*gpgme_io_cb_t) (void *DATA, int FD): I/O Callback Interface.
1624 * gpgme_error_t (*gpgme_passphrase_cb_t)(void *HOOK, const char *UID_HINT, const char *PASSPHRASE_INFO, int PREV_WAS_BAD, int FD): Passphrase Callback.
1626 * gpgme_error_t (*gpgme_register_io_cb_t) (void *DATA, int FD, int DIR, gpgme_io_cb_t FNC, void *FNC_DATA, void **TAG): I/O Callback Interface.
1628 * gpgme_error_t (*gpgme_status_cb_t)(void *HOOK, const char *KEYWORD, const char *ARGS): Status Message Callback.
1630 * gpgme_err_code: Error Values. (line 42)
1631 * gpgme_err_code_from_errno: Error Values. (line 97)
1632 * gpgme_err_code_t: Error Values. (line 6)
1633 * gpgme_err_code_to_errno: Error Values. (line 102)
1634 * gpgme_err_make: Error Values. (line 57)
1635 * gpgme_err_make_from_errno: Error Values. (line 82)
1636 * gpgme_err_source: Error Values. (line 49)
1637 * gpgme_err_source_t: Error Values. (line 13)
1638 * gpgme_event_io_t: I/O Callback Interface.
1640 * gpgme_event_io_t <1>: Registering I/O Callbacks.
1642 * gpgme_free: Destroying Data Buffers.
1644 * gpgme_genkey_result_t: Generating Keys. (line 295)
1645 * gpgme_get_armor: ASCII Armor. (line 13)
1646 * gpgme_get_ctx_flag: Status Message Callback.
1648 * gpgme_get_dirinfo: Engine Version Check.
1650 * gpgme_get_engine_info: Engine Information. (line 46)
1651 * gpgme_get_include_certs: Included Certificates.
1653 * gpgme_get_io_cbs: Registering I/O Callbacks.
1655 * gpgme_get_key: Listing Keys. (line 147)
1656 * gpgme_get_keylist_mode: Key Listing Mode. (line 73)
1657 * gpgme_get_offline: Offline Mode. (line 23)
1658 * gpgme_get_passphrase_cb: Passphrase Callback. (line 59)
1659 * gpgme_get_pinentry_mode: Pinentry Mode. (line 14)
1660 * gpgme_get_progress_cb: Progress Meter Callback.
1662 * gpgme_get_protocol: Protocol Selection. (line 21)
1663 * gpgme_get_protocol_name: Protocols and Engines.
1665 * gpgme_get_sender: Setting the Sender. (line 26)
1666 * gpgme_get_sig_key: Deprecated Functions.
1668 * gpgme_get_sig_status: Deprecated Functions.
1670 * gpgme_get_sig_string_attr: Deprecated Functions.
1672 * gpgme_get_sig_ulong_attr: Deprecated Functions.
1674 * gpgme_get_status_cb: Status Message Callback.
1676 * gpgme_get_textmode: Text Mode. (line 20)
1677 * gpgme_hash_algo_name: Hash Algorithms. (line 28)
1678 * gpgme_hash_algo_t: Hash Algorithms. (line 10)
1679 * gpgme_import_result_t: Importing Keys. (line 110)
1680 * gpgme_import_status_t: Importing Keys. (line 72)
1681 * gpgme_interact_cb_t: Advanced Key Editing.
1683 * gpgme_invalid_key_t: Crypto Operations. (line 10)
1684 * gpgme_io_cb_t: I/O Callback Interface.
1686 * gpgme_keylist_result_t: Listing Keys. (line 124)
1687 * gpgme_key_get_string_attr: Deprecated Functions.
1689 * gpgme_key_get_ulong_attr: Deprecated Functions.
1691 * gpgme_key_ref: Manipulating Keys. (line 6)
1692 * gpgme_key_release: Deprecated Functions.
1694 * gpgme_key_sig_get_string_attr: Deprecated Functions.
1696 * gpgme_key_sig_get_ulong_attr: Deprecated Functions.
1698 * gpgme_key_sig_t: Key objects. (line 226)
1699 * gpgme_key_t: Key objects. (line 10)
1700 * gpgme_key_unref: Manipulating Keys. (line 10)
1701 * gpgme_new: Creating Contexts. (line 6)
1702 * gpgme_new_signature_t: Creating a Signature.
1704 * gpgme_off_t: Exchanging Data. (line 24)
1705 * gpgme_op_adduid: Generating Keys. (line 161)
1706 * gpgme_op_adduid_start: Generating Keys. (line 185)
1707 * gpgme_op_assuan_transact_ext: Using the Assuan protocol.
1709 * gpgme_op_assuan_transact_start: Using the Assuan protocol.
1711 * gpgme_op_card_edit: Deprecated Functions.
1713 * gpgme_op_card_edit_start: Deprecated Functions.
1715 * gpgme_op_createkey: Generating Keys. (line 14)
1716 * gpgme_op_createkey_start: Generating Keys. (line 99)
1717 * gpgme_op_createsubkey: Generating Keys. (line 109)
1718 * gpgme_op_createsubkey_start: Generating Keys. (line 151)
1719 * gpgme_op_decrypt: Decrypt. (line 6)
1720 * gpgme_op_decrypt_result: Decrypt. (line 91)
1721 * gpgme_op_decrypt_start: Decrypt. (line 20)
1722 * gpgme_op_decrypt_verify: Decrypt and Verify. (line 6)
1723 * gpgme_op_decrypt_verify_start: Decrypt and Verify. (line 30)
1724 * gpgme_op_delete: Deleting Keys. (line 6)
1725 * gpgme_op_delete_start: Deleting Keys. (line 20)
1726 * gpgme_op_edit: Deprecated Functions.
1728 * gpgme_op_edit_start: Deprecated Functions.
1730 * gpgme_op_encrypt: Encrypting a Plaintext.
1732 * gpgme_op_encrypt_result: Encrypting a Plaintext.
1734 * gpgme_op_encrypt_sign: Encrypting a Plaintext.
1736 * gpgme_op_encrypt_sign_start: Encrypting a Plaintext.
1738 * gpgme_op_encrypt_start: Encrypting a Plaintext.
1740 * gpgme_op_export: Exporting Keys. (line 38)
1741 * gpgme_op_export_ext: Exporting Keys. (line 69)
1742 * gpgme_op_export_ext_start: Exporting Keys. (line 90)
1743 * gpgme_op_export_keys: Exporting Keys. (line 101)
1744 * gpgme_op_export_keys_start: Exporting Keys. (line 124)
1745 * gpgme_op_export_start: Exporting Keys. (line 58)
1746 * gpgme_op_genkey: Generating Keys. (line 225)
1747 * gpgme_op_genkey_result: Generating Keys. (line 328)
1748 * gpgme_op_genkey_start: Generating Keys. (line 283)
1749 * gpgme_op_import: Importing Keys. (line 9)
1750 * gpgme_op_import_ext: Deprecated Functions.
1752 * gpgme_op_import_keys: Importing Keys. (line 35)
1753 * gpgme_op_import_keys_start: Importing Keys. (line 59)
1754 * gpgme_op_import_result: Importing Keys. (line 160)
1755 * gpgme_op_import_start: Importing Keys. (line 24)
1756 * gpgme_op_interact: Advanced Key Editing.
1758 * gpgme_op_interact_start: Advanced Key Editing.
1760 * gpgme_op_keylist_end: Listing Keys. (line 81)
1761 * gpgme_op_keylist_ext_start: Listing Keys. (line 33)
1762 * gpgme_op_keylist_next: Listing Keys. (line 65)
1763 * gpgme_op_keylist_result: Listing Keys. (line 135)
1764 * gpgme_op_keylist_start: Listing Keys. (line 6)
1765 * gpgme_op_keysign: Signing Keys. (line 12)
1766 * gpgme_op_keysign_start: Signing Keys. (line 68)
1767 * gpgme_op_passwd: Changing Passphrases.
1769 * gpgme_op_passwd_start: Changing Passphrases.
1771 * gpgme_op_query_swdb: Checking for updates.
1773 * gpgme_op_query_swdb_result: Checking for updates.
1775 * gpgme_op_revuid: Generating Keys. (line 192)
1776 * gpgme_op_revuid_start: Generating Keys. (line 218)
1777 * gpgme_op_sign: Creating a Signature.
1779 * gpgme_op_sign_result: Creating a Signature.
1781 * gpgme_op_sign_start: Creating a Signature.
1783 * gpgme_op_spawn: Running other Programs.
1785 * gpgme_op_spawn_start: Running other Programs.
1787 * gpgme_op_tofu_policy: Changing TOFU Data. (line 27)
1788 * gpgme_op_tofu_policy_start: Changing TOFU Data. (line 39)
1789 * gpgme_op_trustlist_end: Listing Trust Items. (line 44)
1790 * gpgme_op_trustlist_next: Listing Trust Items. (line 27)
1791 * gpgme_op_trustlist_start: Listing Trust Items. (line 6)
1792 * gpgme_op_verify: Verify. (line 6)
1793 * gpgme_op_verify_result: Verify. (line 262)
1794 * gpgme_op_verify_start: Verify. (line 26)
1795 * gpgme_passphrase_cb_t: Passphrase Callback. (line 10)
1796 * gpgme_pinentry_mode_t: Pinentry Mode. (line 20)
1797 * gpgme_progress_cb_t: Progress Meter Callback.
1799 * gpgme_protocol_t: Protocols and Engines.
1801 * gpgme_protocol_t <1>: Engine Information. (line 7)
1802 * gpgme_pubkey_algo_name: Public Key Algorithms.
1804 * gpgme_pubkey_algo_string: Public Key Algorithms.
1806 * gpgme_pubkey_algo_t: Public Key Algorithms.
1808 * gpgme_query_swdb_result_t: Checking for updates.
1810 * gpgme_recipient_t: Decrypt. (line 30)
1811 * gpgme_register_io_cb_t: I/O Callback Interface.
1813 * gpgme_release: Destroying Contexts. (line 6)
1814 * gpgme_result_ref: Result Management. (line 15)
1815 * gpgme_result_unref: Result Management. (line 21)
1816 * gpgme_set_armor: ASCII Armor. (line 6)
1817 * gpgme_set_ctx_flag: Status Message Callback.
1819 * gpgme_set_engine_info: Engine Configuration.
1821 * gpgme_set_global_flag: Library Version Check.
1823 * gpgme_set_include_certs: Included Certificates.
1825 * gpgme_set_io_cbs: Registering I/O Callbacks.
1827 * gpgme_set_keylist_mode: Key Listing Mode. (line 6)
1828 * gpgme_set_locale: Locale. (line 14)
1829 * gpgme_set_offline: Offline Mode. (line 6)
1830 * gpgme_set_passphrase_cb: Passphrase Callback. (line 36)
1831 * gpgme_set_pinentry_mode: Pinentry Mode. (line 6)
1832 * gpgme_set_progress_cb: Progress Meter Callback.
1834 * gpgme_set_protocol: Protocol Selection. (line 6)
1835 * gpgme_set_sender: Setting the Sender. (line 13)
1836 * gpgme_set_status_cb: Status Message Callback.
1838 * gpgme_set_textmode: Text Mode. (line 6)
1839 * gpgme_signature_t: Verify. (line 88)
1840 * gpgme_signers_add: Selecting Signers. (line 18)
1841 * gpgme_signers_clear: Selecting Signers. (line 11)
1842 * gpgme_signers_count: Selecting Signers. (line 25)
1843 * gpgme_signers_enum: Selecting Signers. (line 29)
1844 * gpgme_sign_result_t: Creating a Signature.
1846 * gpgme_sig_mode_t: Creating a Signature.
1848 * gpgme_sig_notation_add: Signature Notation Data.
1850 * gpgme_sig_notation_clear: Signature Notation Data.
1852 * gpgme_sig_notation_get: Signature Notation Data.
1854 * gpgme_sig_notation_t: Verify. (line 38)
1855 * gpgme_sig_stat_t: Deprecated Functions.
1857 * gpgme_ssize_t: Exchanging Data. (line 30)
1858 * gpgme_status_cb_t: Status Message Callback.
1860 * gpgme_strerror: Error Strings. (line 6)
1861 * gpgme_strerror_r: Error Strings. (line 15)
1862 * gpgme_strsource: Error Strings. (line 26)
1863 * gpgme_subkey_t: Key objects. (line 94)
1864 * gpgme_tofu_policy_t: Changing TOFU Data. (line 11)
1865 * gpgme_trust_item_get_int_attr: Deprecated Functions.
1867 * gpgme_trust_item_get_string_attr: Deprecated Functions.
1869 * gpgme_trust_item_ref: Manipulating Trust Items.
1871 * gpgme_trust_item_release: Deprecated Functions.
1873 * gpgme_trust_item_t: Trust Item Management.
1875 * gpgme_trust_item_unref: Manipulating Trust Items.
1877 * gpgme_user_id_t: Key objects. (line 180)
1878 * gpgme_validity_t: Information About Keys.
1880 * gpgme_verify_result_t: Verify. (line 247)
1881 * gpgme_wait: Waiting For Completion.
1883 * IMPORT_FILES: UI Server Import/Export Keys.
1885 * INPUT: UI Server Encrypt. (line 23)
1886 * INPUT <1>: UI Server Sign. (line 12)
1887 * INPUT <2>: UI Server Decrypt. (line 12)
1888 * INPUT <3>: UI Server Verify. (line 16)
1889 * MESSAGE: UI Server Verify. (line 10)
1890 * MICALG: UI Server Sign. (line 43)
1891 * off_t (*gpgme_data_seek_cb_t) (void *HANDLE, off_t OFFSET, int WHENCE): Callback Based Data Buffers.
1893 * OUTPUT: UI Server Encrypt. (line 36)
1894 * OUTPUT <1>: UI Server Sign. (line 18)
1895 * OUTPUT <2>: UI Server Decrypt. (line 19)
1896 * OUTPUT <3>: UI Server Verify. (line 23)
1897 * PREP_ENCRYPT: UI Server Encrypt. (line 72)
1898 * PROTOCOL: UI Server Encrypt. (line 98)
1899 * RECIPIENT: UI Server Encrypt. (line 9)
1900 * SENDER: Miscellaneous UI Server Commands.
1902 * SESSION: Miscellaneous UI Server Commands.
1904 * SIGN: UI Server Sign. (line 33)
1905 * SIGN_FILES: UI Server Sign/Encrypt Files.
1907 * SIGSTATUS: UI Server Verify. (line 56)
1908 * ssize_t (*gpgme_data_read_cb_t) (void *HANDLE, void *BUFFER, size_t SIZE): Callback Based Data Buffers.
1910 * ssize_t (*gpgme_data_write_cb_t) (void *HANDLE, const void *BUFFER, size_t SIZE): Callback Based Data Buffers.
1912 * START_CONFDIALOG: Miscellaneous UI Server Commands.
1914 * START_KEYMANAGER: Miscellaneous UI Server Commands.
1916 * struct gpgme_data_cbs: Callback Based Data Buffers.
1918 * struct gpgme_io_cbs: Registering I/O Callbacks.
1920 * VERIFY: UI Server Verify. (line 31)
1921 * VERIFY_FILES: UI Server Verify/Decrypt Files.
1923 * void (*gpgme_data_release_cb_t) (void *HANDLE): Callback Based Data Buffers.
1925 * void (*gpgme_event_io_cb_t) (void *DATA, gpgme_event_io_t TYPE, void *TYPE_DATA): I/O Callback Interface.
1927 * void (*gpgme_progress_cb_t)(void *HOOK, const char *WHAT, int TYPE, int CURRENT, int TOTAL): Progress Meter Callback.
1929 * void (*gpgme_remove_io_cb_t) (void *TAG): I/O Callback Interface.
1931 * window-id: Miscellaneous UI Server Commands.
projects / platform / upstream / gpgme.git / blob