├── AUTHORS
├── TODO
├── depfinder-search
    ├── defs.h
    ├── CWhatProvides.h
    ├── Makefile
    ├── main.cpp
    └── CWhatProvides.cpp
├── INSTALL
├── Makefile
├── README
├── man
    └── depfinder.t2t
├── ChangeLog
├── depfinder
└── COPYING


/AUTHORS:
--------------------------------------------------------------------------------
1 | George Vlahavas (vlahavas~at~gmail~dot~com)
2 | 


--------------------------------------------------------------------------------
/TODO:
--------------------------------------------------------------------------------
1 | * Rewrite depfinder-search from scratch in C (don't hold your breath)
2 | * Perhaps add support for detecting perl dependencies
3 | 


--------------------------------------------------------------------------------
/depfinder-search/defs.h:
--------------------------------------------------------------------------------
 1 | // See COPYING for license information.
 2 | 
 3 | // Defines to be used for loading file names.
 4 | #ifndef TMPDIR
 5 | #define TMPDIR		"/tmp/depfinder."
 6 | #endif
 7 | #ifndef TMPFILE
 8 | #define TMPFILE(file,shellpid)	std::string(TMPDIR + std::string(shellpid) + std::string(file) )
 9 | #endif
10 | 


--------------------------------------------------------------------------------
/depfinder-search/CWhatProvides.h:
--------------------------------------------------------------------------------
 1 | // This class takes a file name and attempts to determine which package
 2 | // or packages that file could have come from, out of the packages which
 3 | // have been installed.
 4 | // See COPYING for license information.
 5 | 
 6 | #ifndef CWHATPROVIDES_H
 7 | #define CWHATPROVIDES_H
 8 | 
 9 | #include <iostream>
10 | 
11 | class CWhatProvides
12 | {
13 | public:
14 | 	CWhatProvides(std::string& file, std::string& shellpid);
15 | protected:
16 | 	void	search_package(const std::string& package, const std::string& file);
17 | };
18 | 
19 | #endif
20 | 


--------------------------------------------------------------------------------
/INSTALL:
--------------------------------------------------------------------------------
 1 | Installation
 2 | ------------
 3 | 
 4 | To install, just run:
 5 | 
 6 |  make
 7 | 
 8 | followed by:
 9 | 
10 |  make install
11 | 
12 | as root. You can set DESTDIR to change the installation target:
13 | 
14 |  make install DESTDIR=/my/custom/installation/target
15 | 
16 | You can set the CPU arch to use with an ARCH variable, like this:
17 | 
18 |  make install ARCH=i586
19 | 
20 | The default value is ARCH=x86_64.
21 | 
22 | 
23 | Uninstallation
24 | --------------
25 | To remove, you can just:
26 | 
27 |  rm /usr/bin/depfinder
28 |  rm /usr/libexec/depfinder-search
29 |  rm /usr/share/locale/*/LC_MESSAGES/depfinder.mo
30 | 


--------------------------------------------------------------------------------
/depfinder-search/Makefile:
--------------------------------------------------------------------------------
 1 | ARCH ?= x86_64
 2 | 
 3 | CCEXTRAS = -Wall -Wextra
 4 | ifeq ($(ARCH),i486)
 5 | 	CXXFLAGS = -O3 -march=i486 -mtune=i686 -fomit-frame-pointer
 6 | else ifeq ($(ARCH),i586)
 7 | 	CXXFLAGS = -O3 -march=i586 -mtune=i686 -fomit-frame-pointer
 8 | else ifeq ($(ARCH),i686)
 9 | 	CXXFLAGS = -O3 -march=i686 -mtune=i686 -fomit-frame-pointer
10 | else
11 | 	CXXFLAGS = -O3 -fPIC -fomit-frame-pointer
12 | endif
13 | 
14 | depfinder-search:
15 | 	g++ -c $(CCEXTRAS) $(CXXFLAGS) CWhatProvides.cpp -o CWhatProvides.o
16 | 	g++ $(CCEXTRAS) $(CXXFLAGS) -o depfinder-search main.cpp CWhatProvides.o
17 | 
18 | clean:
19 | 	rm -f CWhatProvides.o
20 | 	rm -f depfinder-search
21 | 


--------------------------------------------------------------------------------
/depfinder-search/main.cpp:
--------------------------------------------------------------------------------
 1 | // Author: George Vlahavas
 2 | // Well, not really, this is just a hack of zpm that is created by:
 3 | // Author: Nigel Bosch
 4 | // std::string Email = "sparkynigel" + "@" + "gmail" + ".com";
 5 | // See COPYING for license information.
 6 | 
 7 | #include <iostream>
 8 | #include <getopt.h>
 9 | #include <vector>
10 | #include "defs.h"
11 | #include "CWhatProvides.h"
12 | 
13 | #define SET_ACTION(action) _action = action
14 | 
15 | int main(int argc, char* argv[])
16 | {
17 | 	std::vector<std::string>	_files;
18 | 	std::string			_arg_whatprovides;
19 | 	std::string			_shell_pid;
20 | 
21 | 	_arg_whatprovides = argv[1];
22 | 	_shell_pid = argv[2];
23 | 
24 | 	CWhatProvides	_ori(_arg_whatprovides, _shell_pid);
25 | 	return 0;
26 | }
27 | 


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
 1 | ARCH ?= x86_64
 2 | 
 3 | CCEXTRAS="-Wall -Wextra"
 4 | 
 5 | ifeq ($(ARCH),x86_64)
 6 | 	LIBDIRSUFFIX = 64
 7 | else
 8 | 	LIBDIRSUFFIX = ""
 9 | endif
10 | 
11 | all: depfinder-search man
12 | 
13 | depfinder-search:
14 | 	$(MAKE) -C depfinder-search/
15 | 
16 | man:
17 | 	@txt2tags -o man/depfinder.man man/depfinder.t2t || \
18 | 	echo "WARNING: txt2tags is not installed. The depfinder manpage will not be created."
19 | 
20 | install:
21 | 	install -d -m 755 $(DESTDIR)/usr/bin
22 | 	install -d -m 755 $(DESTDIR)/usr/libexec
23 | 	install -m 755 depfinder $(DESTDIR)/usr/bin/
24 | 	sed -i "s/^LIBDIRSUFFIX=.*/LIBDIRSUFFIX=\"$(LIBDIRSUFFIX)\"/" \
25 | 		$(DESTDIR)/usr/bin/depfinder
26 | 	install -m 755 depfinder-search/depfinder-search $(DESTDIR)/usr/libexec/
27 | 	[ -f man/depfinder.man ] && \
28 | 		install -D -m 644 man/depfinder.man $(DESTDIR)/usr/man/man1/depfinder.1
29 | 
30 | clean:
31 | 	rm -f man/depfinder.man
32 | 	$(MAKE) clean -C depfinder-search/
33 | 
34 | .PHONY: install clean depfinder-search man
35 | 


--------------------------------------------------------------------------------
/depfinder-search/CWhatProvides.cpp:
--------------------------------------------------------------------------------
 1 | // See COPYING for license information.
 2 | 
 3 | #include <fstream>
 4 | #include <algorithm>
 5 | #include "defs.h"
 6 | #include "CWhatProvides.h"
 7 | 
 8 | CWhatProvides::CWhatProvides(std::string& file, std::string& shellpid)
 9 | {
10 | 	// Mangle the request to be more easily seachable.
11 | 	if ( file.find(".new") == file.length() - 1 && (int)file.find(".new") != -1 )
12 | 		file.erase(file.length() - 4);
13 | 
14 | 	// Go through all installed packages.
15 | 	std::ifstream	_logfile;
16 | 	std::string	_inputstr;
17 | 	_logfile.open(TMPFILE("/pkglist.log", shellpid).c_str(), std::ios_base::in);
18 | 	while ( !_logfile.eof() ) {
19 | 		getline(_logfile, _inputstr);
20 | 		if ( _inputstr.length() > 0 ) search_package("/var/lib/pkgtools/packages/" + _inputstr, file);
21 | 	}
22 | 	_logfile.close();
23 | }
24 | 
25 | void CWhatProvides::search_package(const std::string& package, const std::string& file)
26 | {	// Search a specific package for the requested file.
27 | 	std::ifstream	_ifpkg;
28 | 	std::string	_instr;
29 | 	bool		_file_list = false;
30 | 	_ifpkg.open(package.c_str(), std::ios_base::in);
31 | 
32 | 	while ( _ifpkg.is_open() && !_ifpkg.eof() ) {
33 | 		getline(_ifpkg, _instr);
34 | 		std::string	_original_fname = _instr;
35 | 		
36 | 		if ( _file_list ) {
37 | 			_instr = "/" + _instr;
38 | 			if ( (int)_instr.find(file) != -1 )
39 | 				std::cout << package.substr((int)package.rfind('/') + 1) << "\n";
40 | 		} else {
41 | 			std::transform(_instr.begin(), _instr.end(), _instr.begin(), tolower);
42 | 			if ( !_instr.find("file list:") ) {
43 | 				_file_list = true;
44 | 			}
45 | 		}
46 | 	}
47 | }
48 | 


--------------------------------------------------------------------------------
/README:
--------------------------------------------------------------------------------
 1 | depfinder is a tool that finds the dependencies of Slackware packages.
 2 | 
 3 | depfinder is much faster than requiredbuilder, a very nice script
 4 | by Stefano Stabellini that I used in the past to find package
 5 | dependencies. But requiredbuilder is written entirely in bash and I
 6 | had always thought that optimizing the search routines in C or C++
 7 | would make the whole process a lot faster. So, the speed difference
 8 | mainly comes from the C++ code that is used in depfinder to find in
 9 | which package each individual library is included. That C++ code is
10 | 'borrowed' (as in blatanly ripped) from Nigel Bosch's zpm code.
11 | 
12 | depfinder also has support for running multiple jobs in parallel that
13 | makes it a lot faster when used with multiple CPUs/cores.
14 | 
15 | The dependency list is by default being output in a comma separated
16 | list, without version information, but there are options to output
17 | dependencies with version information and to a file: a .dep file
18 | with a comma separated list without version information, or a
19 | slack-required file with version information, respectively.
20 | 
21 | Note that I don't really agree with version information in
22 | dependency lists. "libxyz >= 1.0-i486-2gv" actually doesn't always
23 | mean that the package will work with any version of libxyz greater
24 | than 1.0. There will be cases that it will have to be rebuilt with
25 | a new libxyz version. Also the check will fail if someone has
26 | "libxyz >= 1.0-i486-1xy" installed since "1xy"<"2gv". But the two
27 | libxyz packages might really be identical otherwise. Using
28 | "libxyz = 1.0-i486-2gv" is not a solution, since the check will
29 | always fail with any subsequent libxyz packages, prompting for
30 | a package rebuild, which would be completely unnecessary. But this is
31 | the format used as standard for slack-required files that are used by
32 | many slackware-based projects, so I added support for it anyway.
33 | 
34 | I also don't personally agree with slack-required files being
35 | inside packages, which I think is a very poor and inefficient design.
36 | A simple change in the dependency list, which would otherwise require
37 | the editing of a text file only, requires rebuilding the package, which
38 | then requires reuploading and redistributing the package, for the users
39 | only to upgrade to a version that in terms of functionality is identical
40 | to the one they have with the previously installed package. Lots of
41 | work, time and bandwidth can be completely wasted that way.
42 | But that's really a whole different matter and I'll stop my ranting
43 | now, since everyone can do whatever he wants with the dependency list
44 | he gets with depfinder.
45 | 
46 | depfinder is perfectly accurate when detecting dependencies of binary
47 | files. I didn't want to implement support for detecting python
48 | dependencies until I was sure I could do it in a way that would really
49 | work. I didn't want to go the way requiredbuilder went and "pretend" to
50 | have support for detecting python dependencies. Detecting python as a
51 | dependency and detecting python dependencies is not at all the same
52 | thing. The way it works now in depfinder I think is the best way it can
53 | be done. All python files in a package are parsed for modules that they
54 | import (or try to import). In most cases there is going to be some extra
55 | output in the form of warnings and the packager might need to do some
56 | manual work to sort out which python dependencies are optional and which
57 | are not, but at least there is no chance that a python dependency will
58 | not be reported (I think). Python dependency checking is going to make
59 | depfinder run a bit slower, it needs to do a lot of work, probing every
60 | single file in the package and parsing all python scripts for certain
61 | keywords, but it's not really that bad in terms of speed. Support for
62 | detecting perl dependencies might be a possibility for the future.
63 | 
64 | Apart from basic shell commands, like ls, sed, touch etc, depfinder
65 | requires python in order to detect python dependencies. You also need to
66 | have the gcc-g++ compiler, so that depfinder-search can be compiled.
67 | 
68 | A huge thanks goes to Nigel Bosch for creating the original code for his
69 | zpm package manager and making it available in the first place.
70 | 


--------------------------------------------------------------------------------
/man/depfinder.t2t:
--------------------------------------------------------------------------------
  1 | depfinder
  2 | George Vlahavas
  3 | %%mtime(%m/%d/%Y)
  4 | 
  5 | %!target: man
  6 | %!encoding: utf-8
  7 | 
  8 | = NAME =
  9 | 
 10 | depfinder - a tool that finds dependencies of slackware packages
 11 | 
 12 | 
 13 | = SYNOPSIS =
 14 | 
 15 | **depfinder** [//OPTIONS//] //PACKAGE// or //PACKAGING-DIRECTORY//
 16 | 
 17 | 
 18 | = DESCRIPTION =
 19 | 
 20 | **depfinder** is a tool that finds the dependencies of Slackware packages.
 21 | It examines binary files in the packages and the libraries they link to and
 22 | reports the packages these libraries belong to in a dependency list.
 23 | The dependencies are by default being output to a comma separated
 24 | list without version information, but there are options to output
 25 | dependencies with version information and to a file: a .dep file
 26 | with a comma separated list without version information, or a
 27 | //slack-required// file that includes version information.
 28 | 
 29 | **depfinder** can check //.tgz//, //.tbz//, //.tlz//, //.txz// and
 30 | //.tbr// packages for dependencies
 31 | but you can also point it to a packaging directory where you have the
 32 | package contents extracted.
 33 | 
 34 | **depfinder** uses **ldd** for discovering dependencies, and finds
 35 | dependencies of binary files with it. Detecting python dependencies is
 36 | also  supported by use of the **-p** switch.
 37 | 
 38 | If a certain library is included in more than one packages, then all
 39 | packages that include it will be listed in one entry using an "or"
 40 | statement (which is expressed with the pipe symbol: "|"). For example a
 41 | dependency for a library that is included in both //openssl// and
 42 | //openssl-solibs// packages will be output as:
 43 | //openssl|openssl-solibs//.
 44 | 
 45 | You need to have all required dependencies for any package you run
 46 | **depfinder** on installed in your system. That will of course always be
 47 | the case when you are building your own packages. In case there is a
 48 | library that is required by a package you run **depfinder** on that is
 49 | missing from your system, **depfinder** will report the missing library
 50 | and will not generate a dependency list.
 51 | 
 52 | If a python module that is needed by a package is not present in the
 53 | system, a warning will be displayed instead of an error and the
 54 | dependency list will be generated. Consider these warnings as hints for
 55 | missing dependencies, optional or not. If your python application doesn't
 56 | work, it's probably because of one or more of those reported missing
 57 | modules. If your application seems to work fine, but you still get some
 58 | warnings, it might mean that your application might acquire some extra
 59 | functionality by installing some of the reported modules. And as the
 60 | python code parsing cannot be perfectly accurate, there might be some
 61 | false positives in these warnings. A line that only reads "import foo"
 62 | for example, that is inside a block quote in a python file. is going to be
 63 | parsed anyway and "foo" will be reported as a missing module, even
 64 | though it's inside a block quote and will never be executed by python.
 65 | 
 66 | **depfinder** also has support for running multiple jobs which makes it
 67 | a **lot** faster on PCs with multiple CPUs/cores.
 68 | 
 69 | 
 70 | = OPTIONS =
 71 | 
 72 | : **-f**
 73 | Outputs dependencies to a file instead of stdout. By default it creates a
 74 | .dep file with a comma separated list of dependencies without version
 75 | information. See also **-s**.
 76 | 
 77 | : **-s**
 78 | Outputs dependencies including version information. Dependencies will be
 79 | listed in the format following this example: "zlib >= 1.2.3-i486-2". If
 80 | combined with **-f**, it creates a slack-required file which can be
 81 | placed inside the package under the //install// directory.
 82 | 
 83 | : **-a**
 84 | Checks all files in the directory tree instead of following the FHS. If
 85 | **-a** is not used, then depfinder looks for binary files only under
 86 | ///sbin// ,///usr/sbin//, ///usr/bin//, ///bin//, ///usr/libexec// and
 87 | ///usr/lib//, ///lib// or ///usr/lib64//, ///lib64// for 32-bit and
 88 | 64-bit architectures respectively. If **-a** is used, then depfinder
 89 | searches for files dynamically linking to libraries anywhere inside the
 90 | package. This option could be usefull if the installation scripts put
 91 | binaries in a non-standard location.
 92 | 
 93 | : **-p**
 94 | Attempts to discover python dependencies. Using this switch, depfinder
 95 | searches for all files that can be recognized as python scripts.
 96 | All python files that are detected are parsed for modules that they
 97 | import and depfinder ultimately reports which packages these modules
 98 | belong to along with all other detected dependencies. The list of
 99 | reported python dependencies might not be final. Some python
100 | packages might be reported as dependencies, while actually being
101 | optional dependencies. This is because an //import// command in python
102 | might be executed after a conditional statement, or only after some
103 | certain action is taken by the end user etc. For example, a python
104 | module might only be providing extra functionality to an application and
105 | it may be imported only after it has been established that it is
106 | present in the system. If it isn't, it won't be imported at all, so the
107 | application will work without it anyway, albeit with some missing
108 | functionality perhaps. It's up to the packager to determine which of
109 | the reported python dependencies are actually dependencies and which
110 | ones should merely be suggested packages.
111 | 
112 | : **-3**
113 | If you use the **-p** option to detect python dependencies, the default
114 | python version that will be used is python 2. This option turns on
115 | support for python 3. Note that it is possible to detect only python 2
116 | or only python 3 dependencies in a single run, not both. This option
117 | only makes sense when used together with the **-p** option, otherwise it
118 | does nothing.
119 | 
120 | : **-j** //jobs//
121 | Specifies the number of parallel depfinder jobs to run. depfinder will
122 | finish considerably faster if this matches exactly the number of your
123 | CPUs/cores (default number of jobs: 1)
124 | 
125 | 
126 | = GENERAL OPTIONS =
127 | 
128 | : **-v**
129 | Shows version information for depfinder and exits.
130 | 
131 | : **-h**
132 | Prints a usage message briefly summarizing all command-line options
133 | and exits.
134 | 
135 | 
136 | = WEBSITE =
137 | 
138 | http://depfinder.sourceforge.net/
139 | 
140 | 
141 | = AUTHORS =
142 | 
143 | depfinder was written by George Vlahavas <vlahavas~at~gmail~dot~com>
144 | 
145 | 
146 | = SEE ALSO =
147 | 
148 | **ldd**(1)
149 | 


--------------------------------------------------------------------------------
/ChangeLog:
--------------------------------------------------------------------------------
  1 | version 1.4.5 ()
  2 |   * Update brotli command for newer brotli release
  3 | 
  4 | version 1.4.4 (2016-09-28):
  5 |   * Improve self-exclusion from dependency list
  6 |   * Make it possible to run depfinder on a package that is located in a
  7 |     different directory than the current one
  8 | 
  9 | version 1.4.3 (2016-02-25):
 10 |   * Add support for .tbr packages
 11 | 
 12 | version 1.4.2 (2015-10-01):
 13 |   * Remove gettext support
 14 |   * Add support for python 3
 15 |   * Switch to using a proper Makefile for building/installation
 16 |   * Update translations
 17 | 
 18 | version 1.4.1 (2013-06-01):
 19 |   * Add detection of a "secret" DEPFINDERNOEXIT variable. If set to 1,
 20 |     depfinder will not stop, even if there are libraries that are needed
 21 |     by the package but are not present in the system.
 22 |   * Add a partial arabic translation.
 23 |   * Update all other translations from transifex.
 24 | 
 25 | version 1.4.0 (2012-05-15):
 26 |   * Check if a file is an ELF executable instead of checking if it has
 27 |     the executable flag set. Some shared libraries do not have the
 28 |     executable flag set, so depfinder was unable to trace them.
 29 |     Thanks JRD!
 30 |   * When asking for python dependencies, make sure the python module is
 31 |     an exact match and not only a partial match.
 32 |   * Added portuguese (pt_PT) and russian (ru) translations.
 33 | 
 34 | version 1.3.9 (2011-03-16):
 35 |   * Fixed a rarely occurring bug with not reading included libraries
 36 |     properly.
 37 | 
 38 | version 1.3.8 (2011-02-13):
 39 |   * Fixed a bug which accidentally removed the package's name from the
 40 |     dependency list, if the name was part of the dependency.
 41 | 
 42 | version 1.3.7 (2011-02-12):
 43 |   * Fixed a bug with reinstating an error message when dependencies were
 44 |     not installed.
 45 |   * Updated translations, including new translations for Japanese,
 46 |     Ukranian, and Swedish
 47 | 
 48 | version 1.3.6 (2010-06-17):
 49 |   * Fixed a problem with detecting some dependencies that were missed
 50 |     before.
 51 | 
 52 | version 1.3.5 (2010-06-14):
 53 |   * Disabled the exclusion of aaa_elflibs and glibc-* packages and fixed
 54 |     minor bug that would sometimes put a leading comma in the dependency
 55 |     list.
 56 | 
 57 | version 1.3.4 (2010-05-24)
 58 |   * Fixed a bug that would make depfinder run forever if it encountered
 59 |     a python file with spaces in its filename.
 60 | 
 61 | version 1.3.3 (2010-05-20)
 62 |   * Fixed broken detection of included libraries
 63 |   * Added Ukranian translation
 64 |   * Added Dutch translation
 65 |   * Added Polish translation
 66 |   * Updated Danish and Italian translations
 67 | 
 68 | version 1.3.2 (2010-03-24)
 69 |   * Fixed a bug with excluding packages
 70 |   * Added Danish, Italian, Spanish and Argentinian Spanish translations
 71 | 
 72 | version 1.3.1 (2010-02-26)
 73 |   * Added Brazilian Portuguese translation
 74 | 
 75 | version 1.3.0 (2010-01-28)
 76 |   * Added support for detecting python dependencies
 77 | 
 78 | version 1.2.2 (2009-12-24)
 79 |   * Fixed a bug where no dependencies were displayed when the number of
 80 |     jobs was larger than the number of libraries included in the
 81 |     package
 82 |   * Fixed a bug with not splitting the jobs properly resulting to an
 83 |     error message
 84 |   * Speed optimizations by removing the dependency on python
 85 |   * Fixed removing default excluded packages
 86 | 
 87 | version 1.2.1 (2009-12-13)
 88 |   * Added manpage
 89 | 
 90 | version 1.2.0 (2009-12-08)
 91 |   * Removed support for the ADD and EXCLUDE environment variables. It's
 92 |     easy enough to do this with standard tools like sed, or by editing
 93 |     the dependency list manually. No reason to keep complicating
 94 |     depfinder for it, lets keep things as simple as possible.
 95 |   * Fixed not detecting dependencies when ldd pointed to a symlink to
 96 |     the actual library and the symlink was not included in the package
 97 |     contents in /var/log/packages/ (thanks Emmanuel Bailleul)
 98 |   * Made it possible to launch the installation scripts from a different
 99 |     directory
100 | 
101 | version 1.1.4 (2009-12-05)
102 |   * Fixed extraction of txz packages that was broken with xz-4.999.9beta
103 | 
104 | version 1.1.3 (2009-11-18)
105 |   * Fixed more things in the French translation
106 | 
107 | version 1.1.2 (2009-11-18)
108 |   * Fixed some strings in the French translation
109 | 
110 | version 1.1.1 (2009-11-17)
111 |   * Added French translation
112 | 
113 | version 1.1.0 (2009-10-02)
114 |   * Added localization support
115 |   * Nicer "libraries not found" error message.
116 |   * Changed the way the compile.sh and install.sh scripts work.
117 | 
118 | version 1.0.2 (2009-08-30)
119 |   * Bugfixes for the OR statement when outputing to comma separated
120 |     list.
121 | 
122 | version 1.0.1 (2009-08-30)
123 |   * Bugfixes for the OR statement combined with the -s switch
124 | 
125 | version 1.0.0 (2009-08-29)
126 |   * Placed the pkglist.log file in a different directory per process, so
127 |     there is no need for any lock files anymore (thanks for the idea
128 |     Dimitar Stankov)
129 |   * Added support for x86_64 arch, by passing the -64 switch to
130 |     install.sh
131 |   * Added support for OR statements using the "|" operator in dependency
132 |     lists.
133 |   * aaa_elflibs is never listed as a dependency
134 | 
135 | versjkon 0.9.2 (2009-06-12)
136 |   * Removed some unneeded lowercasing (thanks for the patch Dimitar
137 |     Stankov)
138 | 
139 | version 0.9.1 (2009-06-12)
140 |   * Fixed use of EXCLUDE environment variable that was broken since
141 |     the addition of -s (thanks for the patch Dimitar Stankov)
142 |   * The ADD environment variable works properly now combined with -s
143 |   * ADD now takes priority over EXCLUDE
144 | 
145 | version 0.9 (2009-06-11)
146 |   * Added -s option to include version information in dependencies
147 |     list. Creates a slack-required file if combined with -f.
148 | 
149 | version 0.8.1 (2009-06-09)
150 |   * Apply lock to removing /tmp/depfinder-pkglist.log too
151 |   * Used LOCKFILE variable for the lock file location (thanks for the
152 |     patch Dimitar Stankov)
153 |   * /var/lock/depfinder/ with write priviliges for everyone is
154 |     installed by default
155 |   * Used basename for the DEPFILENAME (thanks for the patch Dimitar
156 |     Stankov)
157 | 
158 | version 0.8 (2009-06-09)
159 |   * Apply lock to /tmp/depfinder-pkglist.log, so there is no chance of
160 |     overwritting the file while reading it (thanks for the idea
161 |     Dimitar Stankov!). flock is used for that, so depfinder now also
162 |     needs util-linux-ng to be installed.
163 | 
164 | version 0.7.1 (2009-05-10)
165 |   * Fixed receiving a directory as an argument
166 | 
167 | version 0.7 (2009-05-09)
168 |   * Added support for txz packages
169 |   * Changed a Zenwalk specific error message to something more general
170 | 
171 | version 0.6 (2009-04-15)
172 |   * Added support for tbz and tlz packages
173 | 
174 | version 0.5 (2009-03-06)
175 |   * Don't search for dependencies that are included in the same package
176 | 
177 | version 0.4.1 (2009-01-31)
178 |   * Outputs error messages to stderr instead of stdout
179 | 
180 | version 0.4 (2009-01-27)
181 |   * Can now use a directory with the package structure directly
182 |   * Fix bad dependency calculation for "not found" libraries, a proper error
183 |     message is shown instead
184 |   * Removed testing for root user priviliges, can now be run as a
185 |     non-priviliged user
186 |   * Added support for ADD and EXCLUDE environment variables for adding or
187 |     excluding deps respectively
188 | 
189 | version 0.3.1 (2009-01-26)
190 | 
191 |   * Replaced bc with python for calculations
192 |   * Fixed error when ldd mistakes a script for a dynamic executable
193 | 
194 | version 0.3 (2009-01-25)
195 | 
196 |   * Added support for multiple jobs with the -j# switch
197 |   * Many small performance enhancements
198 | 
199 | version 0.2 (2009-01-23)
200 | 
201 |   * Initial public release
202 | 


--------------------------------------------------------------------------------
/depfinder:
--------------------------------------------------------------------------------
  1 | #!/bin/bash
  2 | #
  3 | # depfinder - a script that finds slackware package dependencies.
  4 | #
  5 | # Written by George Vlahavas 
  6 | # (vlahavas~at~gmail~dot~com)
  7 | #
  8 | # Licensed under the GPL v3
  9 | 
 10 | VERSION=1.4.4
 11 | 
 12 | CWD=`pwd`
 13 | 
 14 | # Set default settings
 15 | CREATEDEPFILE=0
 16 | CHECKALLFILES=0
 17 | VERSIONINFO=0
 18 | PYTHONDEPS=0
 19 | JOBS=1
 20 | STARTDIR=""
 21 | DEPVER=""
 22 | DEBUG=${DEBUG:-0}
 23 | DEPFINDERSEARCH="/usr/libexec/depfinder-search"
 24 | LIBDIRSUFFIX=""
 25 | 
 26 | # help message
 27 | help_msg()
 28 | {
 29 | echo \
 30 | "depfinder: finds the dependencies of Slackware packages
 31 | 
 32 | usage: depfinder [OPTIONS] <package.tgz|.txz|.tlz|.tbz|.tbr or packaging-dir>
 33 | 
 34 | OPTIONS:
 35 |     -f,          Output dependencies to a file instead of stdout.
 36 |                  By default it creates a .dep file. See also -s.
 37 |     -s,          Outputs dependencies with version information. If
 38 |                  combined with -f, it creates a slack-required file
 39 |     -a,          Checks all files in the directory tree instead of
 40 |                  following the FHS
 41 |     -p,          Attempts to detect python dependencies.
 42 |     -3,          Uses python 3 instead of 2 (works only with -p)
 43 |     -j [jobs],   The number of parallel depfinder jobs to run. Faster
 44 |                  if it matches the number of your CPUs/cores
 45 |                  (default: 1)
 46 |     -v,          Show version information
 47 |     -h,          This help message"
 48 | }
 49 | 
 50 | # version message
 51 | ver_msg()
 52 | {
 53 | echo \
 54 | "depfinder version $VERSION (c) 2009-2018 George Vlahavas
 55 | Run "depfinder -h" for help information"
 56 | }
 57 | 
 58 | # Routine to find out where each dependency comes from and output to
 59 | # a file. The C++ code "borrowed" from zpm makes all the difference
 60 | # compared to requiredbuilder here.
 61 | depfind()
 62 | {
 63 | 	touch DEPS$1
 64 | 	for i in `cat LIBS$1`; do
 65 | 		[ -h /$i ] && i=`readlink -e /$i`
 66 | 		$DEPFINDERSEARCH  $i $$ | uniq > TMP$1
 67 | 		if [ `cat TMP$1 | wc -l` -gt 1 ];then
 68 | 			cat TMP$1 | tr '\n' ' ' | \
 69 | 			sed "s/ /|/g" | sed "s/|$//" >> DEPS$1
 70 | 			echo "" >> DEPS$1
 71 | 		else
 72 | 			cat TMP$1 >> DEPS$1
 73 | 		fi
 74 | 	done
 75 | }
 76 | 
 77 | # Function that finds python files in the current directory, where the
 78 | # current directory is always the packaging directory here. Since
 79 | # python scripts could be all over the place, we're looking everywhere
 80 | # in the package by default.
 81 | findpython()
 82 | {
 83 | 	LANG=C find ./ \
 84 | 	-type f -exec bash -c \
 85 | 	"file -b \"{}\" | grep -i \"python script\" 1>/dev/null && echo \"{}\"" \; \
 86 | 	2> /dev/null
 87 | 	find ./ \
 88 | 	-type f -name "*.py"
 89 | }
 90 | 
 91 | # Function that parses python scripts for modules that it imports
 92 | parsepython()
 93 | {
 94 | 	sed "s/;/\n/g" $1 | \
 95 | 	sed -e :a -e '/\\$/N; s/\\\n//; ta' | \
 96 | 	sed "s/[ \t]\+/ /g" | \
 97 | 	grep "^ *import \|^ *from .* import " | \
 98 | 	sed "s/#/@COMMENT@/" | \
 99 | 	sed "s/\(.*\)@COMMENT@.*/\1/" | \
100 | 	sed "s/.*__import__('\(.*\)').*/import \1/" | \
101 | 	sed "s/from \(.*\) import .*/\1/" | \
102 | 	sed "s/^ *import \(.*\)/\1/" | \
103 | 	sed "s/\(.*\) as .*/\1/"  | \
104 | 	sed "s/^[ \t]*//;s/[ \t]*$//" | \
105 | 	sed "/ [^,]\+ /d" | \
106 | 	sed "s/,/\n/g" | \
107 | 	sed "s/^[ \t]*//" | \
108 | 	sed "s/\./@MODULESEPARATOR@/" | \
109 | 	sed "s/\(.*\)@MODULESEPARATOR@.*/\1/" 
110 | }
111 | 
112 | # Function that cleans up temp files
113 | cleanup()
114 | {
115 | 	if [ $DEBUG -eq 0 ]; then
116 | 		rm -rf /tmp/depfinder.$$
117 | 	fi
118 | }
119 | 
120 | # Function to cleanly exit on error (just to be sure)
121 | err()
122 | {
123 | 	cleanup
124 | 	exit 1
125 | }
126 | 
127 | #
128 | # This is where everything starts...
129 | #
130 | 
131 | 
132 | # If no arguments are passed, show an error message
133 | if [ $# -eq 0 ]; then
134 | 	help_msg
135 | 	echo "ERROR: No arguments found." >&2
136 | 	err
137 | fi
138 | 
139 | # check which switches are used
140 | while getopts  ":hvfsap3j:" flag
141 | do
142 | 	# if switch is unknown or if asking for help
143 | 	if [ $flag = "?" ] || [ $flag = "h" ]; then
144 | 		help_msg
145 | 		err
146 | 	fi
147 | 	if [ $flag = "v" ]; then
148 | 		ver_msg
149 | 		err
150 | 	fi
151 | 	if [ $flag = "f" ]; then
152 | 		CREATEDEPFILE=1
153 | 	fi
154 | 	if [ $flag = "s" ]; then
155 | 		VERSIONINFO=1
156 | 	fi
157 | 	if [ $flag = "a" ]; then
158 | 		CHECKALLFILES=1
159 | 	fi
160 | 	if [ $flag = "p" ]; then
161 | 		PYTHONDEPS=1
162 | 	fi
163 | 	if [ $flag = "3" ]; then
164 | 		PYTHON="python3"
165 | 	else
166 | 		PYTHON="python"
167 | 	fi
168 | 	if [ $flag = "j" ]; then
169 | 		# we check if it's a number
170 | 		if [ `echo $OPTARG` -eq `echo $OPTARG` 2> /dev/null ]; then 
171 | 			# and if it's in range (positive number)
172 | 			if [ $OPTARG -ge 1 2> /dev/null ]; then
173 | 			# and only then change the default value
174 | 			JOBS=$OPTARG
175 | 			# if it's out of range show help
176 | 			else
177 | 				help_msg
178 | 				echo "ERROR: Number of jobs must be greater than one" >&2
179 | 				err
180 | 			fi
181 | 		# if it's not a number show help
182 | 		else
183 | 			help_msg
184 | 			err
185 | 		fi
186 | 	fi
187 | done
188 | 
189 | # we shift positions in $@ so that we discard all previous switches
190 | # and leave only files as additional arguments
191 | shift $((OPTIND-1))
192 | 
193 | # Only one package at a time!
194 | if [ $# -gt 1 ]; then
195 | 	help_msg
196 | 	echo "ERROR: Too many arguments" >&2
197 | 	err
198 | fi
199 | 
200 | # test if the package file is there
201 | if [ ! -d $1 ] && [ ! -f $1 ] ; then
202 | 	arg=$1
203 | 	echo "ERROR: $arg not found" >&2
204 | 	err
205 | fi
206 | 
207 | # test if the files is actually a directory...
208 | if [ -d $1 ]; then
209 | 	STARTDIR=`readlink -f $1`/
210 | else
211 | 	# ... or has the .tgz|tbz|tlz extension (is a package file)
212 | 	if [ ! `echo $1 | grep "\.t[gblx]z$\|\.tbr"` ]; then
213 | 		arg=$1
214 | 		echo "ERROR: $arg is not a package file or a directory!" >&2
215 | 		err
216 | 	fi
217 | fi
218 | 
219 | # Cleanup any leftover files before really doing anything
220 | cleanup
221 | 
222 | # Create temp dir and extract package
223 | mkdir -p /tmp/depfinder.$$
224 | ls /var/log/packages > /tmp/depfinder.$$/pkglist.log
225 | 
226 | # Extract only if argument is not a directory
227 | if [ `echo $1 | grep "\.t[gb]z$"` ]; then
228 | 	[ -z $STARTDIR ] && tar xf $1 -C /tmp/depfinder.$$
229 | elif [ `echo $1 | grep "\.tlz$"` ]; then
230 | 	lzma -d -c $1 | tar xf - -C /tmp/depfinder.$$
231 | elif [ `echo $1 | grep "\.txz$"` ]; then
232 | 	xz -d -c $1 | tar xf - -C /tmp/depfinder.$$
233 | elif [ `echo $1 | grep "\.tbr$"` ]; then
234 | 	brotli -c --decompress $1 | tar xf - -C /tmp/depfinder.$$
235 | fi
236 | cd /tmp/depfinder.$$
237 | 
238 | PKGNAME=`basename $1 | sed "s/\.t[gblx]z\|\.tbr\|\/$//"`
239 | 
240 | # Find all binaries and libs in the package
241 | [ -z $STARTDIR ] || cd $STARTDIR
242 | touch /tmp/depfinder.$$/FILES
243 | if [ $CHECKALLFILES -eq 0 ]; then
244 | 	# usually only in standard locations
245 | 	find \
246 | 	{sbin,usr/sbin,usr/bin,bin,usr/lib${LIBDIRSUFFIX},lib${LIBDIRSUFFIX},usr/libexec} \
247 | 	-type f -exec bash -c \
248 | 	"file {} | grep -q ELF && echo "{}" >> /tmp/depfinder.$$/FILES" \; 2> /dev/null
249 | else
250 | 	# or anywhere in the package if -a is specified
251 | 	find ./ \
252 | 	-type f -exec bash -c \
253 | 	"file {} | grep -q ELF && echo "{}" >> /tmp/depfinder.$$/FILES" \; 2> /dev/null
254 | fi
255 | 
256 | # Look for python dependencies
257 | if [ $PYTHONDEPS -eq 1 ]; then
258 | 	# Determine in which directories python looks for modules
259 | 	$PYTHON -c "import sys; print(sys.path)" | \
260 | 	sed "s/'\|,\|\[\|\]//g" | \
261 | 	sed "s/ /\n/g" > /tmp/depfinder.$$/PYTHONDIRS
262 | 
263 | 	# Find all python scripts in the package
264 | 	touch /tmp/depfinder.$$/PYTHONFILES
265 | 	findpython >> /tmp/depfinder.$$/PYTHONFILES
266 | 
267 | 	# Determine which python modules are imported (used)
268 | 	touch /tmp/depfinder.$$/PYTHONMODULESRAW
269 | 	for i in `cat /tmp/depfinder.$$/PYTHONFILES`; do
270 | 		parsepython $i >> /tmp/depfinder.$$/PYTHONMODULESRAW
271 | 	done
272 | 
273 | 	# Sort and clean modules list
274 | 	cat -A /tmp/depfinder.$$/PYTHONMODULESRAW | \
275 | 	sort | sed 's/\^M\$\|\$//' | \
276 | 	uniq > /tmp/depfinder.$$/PYTHONMODULESSORTED
277 | 	
278 | 	# Find which modules are included in the package and create a
279 | 	# list with the ones that are not
280 | 	touch /tmp/depfinder.$$/PYTHONMODULES
281 | 	for i in `cat /tmp/depfinder.$$/PYTHONMODULESSORTED`; do
282 | 		FOUND=`find ./ -type f | grep "/$i\.py$\|/$i/__init__\.py$\|$\.so"`
283 | 		if [[ ! "$FOUND" ]]; then
284 | 			echo "$i" >> /tmp/depfinder.$$/PYTHONMODULES
285 | 		fi
286 | 	done
287 | 
288 | 	# Remove python built-in modules from the list
289 | 	$PYTHON -c "import sys; print(sys.builtin_module_names)" | \
290 | 	sed "s/'\|,\|(\|)//g" > /tmp/depfinder.$$/PYTHONBUILTIN
291 | 	for i in `cat /tmp/depfinder.$$/PYTHONBUILTIN`; do
292 | 		sed -i "/$i/d" /tmp/depfinder.$$/PYTHONMODULES
293 | 	done
294 | 
295 | 	# Find the specific python files that provide the needed python modules
296 | 	touch /tmp/depfinder.$$/PYTHONNEEDEDMODULES
297 | 	for dir in `cat /tmp/depfinder.$$/PYTHONDIRS`; do
298 | 		if [ -d $dir ]; then
299 | 			for i in `cat /tmp/depfinder.$$/PYTHONMODULES`; do
300 | 				if [ -f $dir/$i.py ]; then
301 | 					echo "$dir/$i.py" \
302 | 					>> /tmp/depfinder.$$/PYTHONNEEDEDMODULES
303 | 					sed -i "/^${i}$/d" /tmp/depfinder.$$/PYTHONMODULES
304 | 				elif [ -f $dir/$i/__init__.py ]; then
305 | 					echo "$dir/$i/__init__.py" \
306 | 					>> /tmp/depfinder.$$/PYTHONNEEDEDMODULES
307 | 					sed -i "/^${i}$/d" /tmp/depfinder.$$/PYTHONMODULES
308 | 				elif [ -f $dir/$i.so ]; then
309 | 					echo "$dir/$i.so" \
310 | 					>> /tmp/depfinder.$$/PYTHONNEEDEDMODULES
311 | 					sed -i "/^${i}$/d" /tmp/depfinder.$$/PYTHONMODULES
312 | 				fi		
313 | 			done
314 | 		fi
315 | 	done
316 | 	# Display a warning for python modules that cannot be located in
317 | 	# the system. These are not errors because the modules could be
318 | 	# optional.
319 | 	for i in `cat /tmp/depfinder.$$/PYTHONMODULES`; do
320 | 		echo "WARNING: python module $i not found." >&2
321 | 	done
322 | fi
323 | 
324 | cd /tmp/depfinder.$$
325 | 
326 | # Dump the dependencies to a file
327 | touch LIBSM
328 | for i in `cat FILES`; do
329 | 	LANG=C ldd ${STARTDIR}${i} 2> /dev/null \
330 | 	| grep "=>" \
331 | 	| sed "s/\(.*\) => \/\(.*\) \(.*\)/\2/" \
332 | 	| sed "s/=> not found/NOT FOUND/" \
333 |         | grep -v "=>" >> LIBSM
334 | done
335 | 
336 | # linux-gate.so.1 is always a dead-end so we don't look for that at all
337 | sort LIBSM | uniq | grep -v "linux-gate\.so" > LIBS
338 | 
339 | # Find which libraries are included in the package
340 | find $STARTDIR | grep "\.so" | \
341 | sed "s/\(.*\)\/\(.*\)\.so\(.*\)/\2\.so/" >> INCLUDED
342 | 
343 | # Exclude the included libs from the search list
344 | if [ -f INCLUDED ]; then
345 | 	for i in `cat INCLUDED`; do 
346 | 		sed -i "/^$i$/d" LIBS
347 | 		sed -i "/\t$i NOT FOUND/d" LIBS
348 | 	done
349 | fi
350 | 
351 | # Check if any dependencies are not found and bail out if they are
352 | if [[ `grep "NOT FOUND" LIBS` ]]; then
353 | 	echo "ERROR: package requires libraries not found in the system:" >&2
354 | 	grep "NOT FOUND" LIBS |\
355 | 	sed "s/NOT FOUND//" |\
356 | 	sed "s/\t/ /" >&2
357 | 	if [ "x$DEPFINDERNOEXIT" != "x1" ]; then
358 | 		err
359 | 	fi
360 | fi
361 | 
362 | # Append the list of python modules to the list of libraries that are
363 | # external dependencies
364 | if [ $PYTHONDEPS -eq 1 ]; then
365 | 	cat PYTHONNEEDEDMODULES >> LIBS
366 | fi
367 | 
368 | # Some files in /usr/lib have nasty paths like /usr/lib/../lib/
369 | # as reported by ldd
370 | sed -i "s|lib${LIBDIRSUFFIX}/\.\./||" LIBS
371 | 
372 | # Get the total number of libraries in the package 
373 | TOTALLINES=`wc -l LIBS | sed "s/\(.*\) \(.*\)/\1/"`
374 | 
375 | # The number of jobs can not exceed the number of libraries present in
376 | # the package and cannot be 0 either
377 | [ $JOBS -gt $TOTALLINES ] && JOBS=$TOTALLINES
378 | [ $TOTALLINES -eq 0 ] && JOBS=1
379 | 
380 | # Maximum file number should be $JOBS-1, split starts counting from 0
381 | let MAXFILENO=$JOBS-1
382 | 
383 | # Split the libraries list in parts for running multiple jobs
384 | let LINES=($TOTALLINES/$JOBS)+1
385 | split -d -l $LINES LIBS LIBS
386 | 
387 | # Find the dependencies (run multiple jobs if -j # is set)
388 | for i in $( seq -f "%02.f" 0 $MAXFILENO ); do
389 | 	touch LIBS$i
390 | 	depfind $i &
391 | done
392 | wait
393 | 
394 | # Put all dependencies in a single file
395 | touch DEPS
396 | for i in $( seq -f "%02.f" 0 $MAXFILENO ); do
397 | 	cat DEPS$i >> DEPS
398 | done
399 | 
400 | # Exclude the present package from the dependency list
401 | sed -i "s/|${PKGNAME}//" DEPS
402 | sed -i "s/${PKGNAME}|//" DEPS
403 | sed -i "s/${PKGNAME}//" DEPS
404 | 
405 | if [ $VERSIONINFO -eq 1 ]; then
406 | 	sort DEPS | uniq | \
407 | 	sed ':a;s/\([^ \|]\+\)-\(\([^ \|-]\+\)-\([^ \|-]\+\)-\([^ \|-]\+\)\|?\)/\1 >= \2/g;ta' \
408 | 	> DEPSNAMES
409 | 	for i in `echo $ADD | sed "s/,/ /g"`; do
410 | 		DEPVER=`ls /var/log/packages/$i-* | sed "s|/var/log/packages/$i-||" | grep "^[^\-]*\-[^\-]*\-[^\-]*$"`
411 | 		sed -i "s/^$i$/$i >= $DEPVER/" DEPSNAMES
412 | 	done
413 | else
414 | 	sort DEPS | uniq | \
415 | 	sed ':a;s/\([^ \|]\+\)-\(\([^ \|-]\+\)-\([^ \|-]\+\)-\([^ \|-]\+\)\|?\)/\1/g;ta'  \
416 | 	> DEPSNAMES
417 | fi
418 | 
419 | # Output dependencies list
420 | if [ $VERSIONINFO -eq 1 ]; then
421 | 	# If requesting version info, output the deps to a
422 | 	# slack-required file or to stdout
423 | 	if [ $CREATEDEPFILE -eq 1 ]; then
424 | 		cp DEPSNAMES $CWD/slack-required
425 | 	else
426 | 		cat DEPSNAMES
427 | 	fi
428 | else
429 | 	# If not requesting version info, output the deps to a
430 | 	# .dep file or to stdout
431 | 	if [ $CREATEDEPFILE -eq 1 ]; then
432 | 		BASENAME=`basename "$PKGNAME"`
433 | 		DEPFILENAME=`echo $BASENAME | sed "s/\.t[xgbl]z$\|\.tbr//"`
434 | 		cat DEPSNAMES | \
435 | 		tr "\n" " " | \
436 | 		sed "s/ /,/g" | \
437 | 		sed "s/,$/\n/" | \
438 | 		sed "s/^,//" > $CWD/$DEPFILENAME.dep
439 | 	else
440 | 		cat DEPSNAMES | \
441 | 		tr "\n" " " | \
442 | 		sed "s/ /,/g" | \
443 | 		sed "s/,$/\n/" | \
444 | 		sed "s/^,//"
445 | 	fi
446 | fi
447 | 
448 | # Clean up before exit
449 | cleanup
450 | 
451 | 


--------------------------------------------------------------------------------
/COPYING:
--------------------------------------------------------------------------------
  1 |                     GNU GENERAL PUBLIC LICENSE
  2 |                        Version 3, 29 June 2007
  3 | 
  4 |  Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
  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 |     <one line to give the program's name and a brief idea of what it does.>
635 |     Copyright (C) <year>  <name of author>
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 <http://www.gnu.org/licenses/>.
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 |     <program>  Copyright (C) <year>  <name of author>
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 | <http://www.gnu.org/licenses/>.
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 | <http://www.gnu.org/philosophy/why-not-lgpl.html>.
675 | 


--------------------------------------------------------------------------------