deprec 1.9.3 → 2.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (188) hide show
  1. data/CHANGELOG +280 -0
  2. data/COPYING +19 -0
  3. data/LICENSE +339 -0
  4. data/README +152 -0
  5. data/THANKS +17 -0
  6. data/bin/depify +128 -0
  7. data/docs/EXAMPLE-installing_tracks.txt +41 -0
  8. data/docs/README.nagios +22 -0
  9. data/docs/README.rails +17 -0
  10. data/docs/config_gen_explained.txt +39 -0
  11. data/docs/{README.quickstart → deprec-1.x/deprec-1.x.quickstart} +4 -1
  12. data/docs/{building_edge_capistrano.txt → deprec-1.x/notes.txt} +6 -3
  13. data/docs/old/deprec_banner.gif +0 -0
  14. data/docs/windows_linux.txt +350 -0
  15. data/docs/xen/traffic_monitoring_with_vnstat.txt +95 -0
  16. data/docs/xen/xen-tools-notes.txt +31 -0
  17. data/docs/xen/xen_on_hardy.txt +39 -0
  18. data/lib/deprec.rb +8 -1
  19. data/lib/deprec/capistrano_extensions.rb +442 -0
  20. data/lib/deprec/recipes.rb +50 -233
  21. data/lib/deprec/recipes/aoe.rb +79 -0
  22. data/lib/deprec/recipes/app/mongrel.rb +213 -0
  23. data/lib/deprec/recipes/app/passenger.rb +197 -0
  24. data/lib/deprec/recipes/apt_mirror.rb +99 -0
  25. data/lib/deprec/recipes/ar_sendmail.rb +67 -0
  26. data/lib/deprec/recipes/canonical.rb +68 -0
  27. data/lib/deprec/recipes/db/mysql.rb +144 -0
  28. data/lib/deprec/recipes/db/postgresql.rb +104 -0
  29. data/lib/deprec/recipes/db/sqlite.rb +37 -0
  30. data/lib/deprec/recipes/ddclient.rb +51 -0
  31. data/lib/deprec/recipes/deprec.rb +199 -0
  32. data/lib/deprec/recipes/deprecated.rb +71 -0
  33. data/lib/deprec/recipes/example.rb +115 -0
  34. data/lib/deprec/recipes/git.rb +97 -0
  35. data/lib/deprec/recipes/gitosis.rb +48 -0
  36. data/lib/deprec/recipes/heartbeat.rb +138 -0
  37. data/lib/deprec/recipes/logrotate.rb +54 -0
  38. data/lib/deprec/recipes/lvm.rb +20 -0
  39. data/lib/deprec/recipes/memcache.rb +6 -2
  40. data/lib/deprec/recipes/monit.rb +143 -0
  41. data/lib/deprec/recipes/nagios.rb +305 -0
  42. data/lib/deprec/recipes/network.rb +93 -0
  43. data/lib/deprec/recipes/ntp.rb +103 -0
  44. data/lib/deprec/recipes/php.rb +58 -0
  45. data/lib/deprec/recipes/postfix.rb +115 -0
  46. data/lib/deprec/recipes/rails.rb +300 -55
  47. data/lib/deprec/recipes/ruby/mri.rb +55 -0
  48. data/lib/deprec/recipes/ruby/ree.rb +41 -0
  49. data/lib/deprec/recipes/sphinx.rb +86 -0
  50. data/lib/deprec/recipes/ssh.rb +85 -18
  51. data/lib/deprec/recipes/ssl.rb +55 -0
  52. data/lib/deprec/recipes/starling.rb +119 -0
  53. data/lib/deprec/recipes/svn.rb +163 -183
  54. data/lib/deprec/recipes/trac.rb +239 -62
  55. data/lib/deprec/recipes/ubuntu.rb +18 -100
  56. data/lib/deprec/recipes/users.rb +90 -0
  57. data/lib/deprec/recipes/utils.rb +58 -0
  58. data/lib/deprec/recipes/vnstat.rb +85 -0
  59. data/lib/deprec/recipes/web/apache.rb +119 -0
  60. data/lib/deprec/recipes/web/nginx.rb +172 -0
  61. data/lib/deprec/recipes/wordpress.rb +96 -0
  62. data/lib/deprec/recipes/wpmu.rb +103 -0
  63. data/lib/deprec/recipes/xen.rb +267 -0
  64. data/lib/deprec/recipes/xentools.rb +75 -0
  65. data/lib/deprec/templates/aoe/aoe-init +55 -0
  66. data/lib/deprec/templates/aoe/fence_aoemask +351 -0
  67. data/lib/deprec/templates/apache/namevirtualhosts.conf +5 -0
  68. data/lib/deprec/templates/apt/sources.list +18 -0
  69. data/lib/deprec/templates/apt_mirror/apt-mirror-cron +4 -0
  70. data/lib/deprec/templates/apt_mirror/mirror.list +33 -0
  71. data/lib/deprec/templates/ar_sendmail/logrotate.conf.erb +9 -0
  72. data/lib/deprec/templates/ar_sendmail/monit.conf.erb +5 -0
  73. data/lib/deprec/templates/ddclient/ddclient.conf.erb +11 -0
  74. data/lib/deprec/templates/ddclient/ddclient.erb +15 -0
  75. data/lib/deprec/templates/deprec/caprc.erb +14 -0
  76. data/lib/deprec/templates/heartbeat/authkeys.erb +2 -0
  77. data/lib/deprec/templates/heartbeat/ha.cf.erb +15 -0
  78. data/lib/deprec/templates/heartbeat/haresources.erb +1 -0
  79. data/lib/deprec/templates/logrotate/logrotate.conf.erb +32 -0
  80. data/lib/deprec/templates/mongrel/apache_vhost.erb +148 -0
  81. data/lib/deprec/templates/mongrel/logrotate.conf.erb +11 -0
  82. data/lib/deprec/{third_party/mongrel_cluster/resources/mongrel_cluster → templates/mongrel/mongrel_cluster-init-script} +19 -6
  83. data/lib/deprec/templates/mongrel/mongrel_cluster.yml.erb +10 -0
  84. data/lib/deprec/templates/mongrel/monit.conf.erb +17 -0
  85. data/lib/deprec/templates/mongrel/nginx_vhost.erb +41 -0
  86. data/lib/deprec/templates/monit/monit-init-script +104 -0
  87. data/lib/deprec/templates/monit/monitrc.erb +227 -0
  88. data/lib/deprec/templates/monit/nothing +0 -0
  89. data/lib/deprec/templates/mysql/create_databases.sql +20 -0
  90. data/lib/deprec/templates/mysql/database.yml.prod +6 -0
  91. data/lib/deprec/templates/mysql/database.yml.stage +6 -0
  92. data/lib/deprec/templates/mysql/my.cnf.erb +140 -0
  93. data/lib/deprec/templates/mysql/sphinx.conf.prod +542 -0
  94. data/lib/deprec/templates/mysql/sphinx.conf.stage +542 -0
  95. data/lib/deprec/templates/nagios/cgi.cfg.erb +321 -0
  96. data/lib/deprec/templates/nagios/check_linux_free_memory.pl +118 -0
  97. data/lib/deprec/templates/nagios/check_mongrel_cluster.rb +82 -0
  98. data/lib/deprec/templates/nagios/commands.cfg.erb +240 -0
  99. data/lib/deprec/templates/nagios/contacts.cfg.erb +57 -0
  100. data/lib/deprec/templates/nagios/hosts.cfg.erb +143 -0
  101. data/lib/deprec/templates/nagios/htpasswd.users +1 -0
  102. data/lib/deprec/templates/nagios/localhost.cfg.erb +157 -0
  103. data/lib/deprec/templates/nagios/nagios.cfg.erb +1274 -0
  104. data/lib/deprec/templates/nagios/nagios_apache_vhost.conf.erb +45 -0
  105. data/lib/deprec/templates/nagios/nrpe.cfg.erb +210 -0
  106. data/lib/deprec/templates/nagios/nrpe.xinetd.erb +16 -0
  107. data/lib/deprec/templates/nagios/resource.cfg.erb +34 -0
  108. data/lib/deprec/templates/nagios/services.cfg.erb +79 -0
  109. data/lib/deprec/templates/nagios/templates.cfg.erb +9 -0
  110. data/lib/deprec/templates/nagios/timeperiods.cfg.erb +94 -0
  111. data/lib/deprec/templates/network/hostname.erb +1 -0
  112. data/lib/deprec/templates/network/hosts.erb +2 -0
  113. data/lib/deprec/templates/network/interfaces.erb +18 -0
  114. data/lib/deprec/templates/network/resolv.conf.erb +6 -0
  115. data/lib/deprec/templates/nginx/logrotate.conf.erb +13 -0
  116. data/lib/deprec/templates/nginx/mime.types.erb +70 -0
  117. data/lib/deprec/templates/nginx/nginx-init-script +62 -0
  118. data/lib/deprec/templates/nginx/nginx.conf.erb +125 -0
  119. data/lib/deprec/templates/nginx/nginx.logrotate.d +12 -0
  120. data/lib/deprec/templates/nginx/nothing.conf +1 -0
  121. data/lib/deprec/templates/nginx/rails_nginx_vhost.conf.erb +41 -0
  122. data/lib/deprec/templates/ntp/ntp.conf.erb +42 -0
  123. data/lib/deprec/templates/passenger/apache_vhost.erb +21 -0
  124. data/lib/deprec/templates/passenger/passenger.conf.erb +21 -0
  125. data/lib/deprec/templates/passenger/passenger.load.erb +3 -0
  126. data/lib/deprec/templates/postfix/aliases.erb +3 -0
  127. data/lib/deprec/templates/postfix/dynamicmaps.cf.erb +8 -0
  128. data/lib/deprec/templates/{postfix_main.conf → postfix/main.cf.erb} +6 -8
  129. data/lib/deprec/templates/postfix/master.cf.erb +77 -0
  130. data/lib/deprec/templates/sphinx/monit.conf.erb +5 -0
  131. data/lib/deprec/templates/ssh/ssh_config.erb +50 -0
  132. data/lib/deprec/templates/ssh/sshd_config.erb +78 -0
  133. data/lib/deprec/templates/ssl/make-ssl-cert +138 -0
  134. data/lib/deprec/templates/ssl/ssl-cert-snakeoil.key +15 -0
  135. data/lib/deprec/templates/ssl/ssl-cert-snakeoil.pem +19 -0
  136. data/lib/deprec/templates/starling/monit.conf.erb +14 -0
  137. data/lib/deprec/templates/starling/starling-init-script.erb +71 -0
  138. data/lib/deprec/templates/subversion/svn.apache.vhost.erb +43 -0
  139. data/lib/deprec/templates/trac/apache_vhost.conf.erb +24 -0
  140. data/lib/deprec/templates/trac/nginx_vhost.conf.erb +26 -0
  141. data/lib/deprec/templates/trac/trac.ini.erb +169 -0
  142. data/lib/deprec/templates/trac/trac_deprec.png +0 -0
  143. data/lib/deprec/templates/trac/tracd-init.erb +43 -0
  144. data/lib/deprec/templates/trac/users.htdigest.erb +0 -0
  145. data/lib/deprec/templates/vnstat/config.php +57 -0
  146. data/lib/deprec/templates/wordpress/apache2_wordpress_vhost.conf.erb +31 -0
  147. data/lib/deprec/templates/wordpress/wp-config.php.erb +31 -0
  148. data/lib/deprec/templates/wpmu/apache_vhost.conf.erb +13 -0
  149. data/lib/deprec/templates/xen/network-bridge-wrapper +3 -0
  150. data/lib/deprec/templates/xen/xend-config.sxp.erb +195 -0
  151. data/lib/deprec/templates/xen/xend-init.erb +57 -0
  152. data/lib/deprec/templates/xen/xendomains.erb +137 -0
  153. data/lib/deprec/templates/xentools/15-disable-hwclock +40 -0
  154. data/lib/deprec/templates/xentools/40-setup-networking +145 -0
  155. data/lib/deprec/templates/xentools/xen-tools.conf.erb +276 -0
  156. data/lib/deprec/templates/xentools/xm.tmpl.erb +138 -0
  157. data/lib/deprec_cmd_completion.sh +26 -0
  158. data/lib/vmbuilder_plugins/all.rb +20 -0
  159. data/lib/vmbuilder_plugins/apt.rb +93 -0
  160. data/lib/vmbuilder_plugins/emerge.rb +76 -0
  161. data/lib/{deprec/third_party/vmbuilder/plugins → vmbuilder_plugins}/gem.rb +10 -17
  162. data/lib/{deprec/third_party/vmbuilder/plugins → vmbuilder_plugins}/std.rb +69 -19
  163. metadata +204 -55
  164. data/bin/deprec +0 -35
  165. data/docs/README.slicehost +0 -14
  166. data/docs/README.svn_trac +0 -19
  167. data/lib/deprec/capistrano_extensions/actor_extensions.rb +0 -89
  168. data/lib/deprec/capistrano_extensions/cli_extensions.rb +0 -38
  169. data/lib/deprec/capistrano_extensions/deprec_extensions.rb +0 -137
  170. data/lib/deprec/generators/deprec/USAGE +0 -11
  171. data/lib/deprec/generators/deprec/deprec_generator.rb +0 -24
  172. data/lib/deprec/generators/deprec/templates/deploy.rb +0 -90
  173. data/lib/deprec/generators/loader.rb +0 -20
  174. data/lib/deprec/recipes/apache.rb +0 -91
  175. data/lib/deprec/recipes/cache_svn.rb +0 -74
  176. data/lib/deprec/recipes/vmware.rb +0 -114
  177. data/lib/deprec/templates/trac.ini.erb +0 -106
  178. data/lib/deprec/third_party/THIRD_PARTY_README +0 -12
  179. data/lib/deprec/third_party/mongrel_cluster/LICENSE +0 -506
  180. data/lib/deprec/third_party/mongrel_cluster/recipes.rb +0 -96
  181. data/lib/deprec/third_party/railsmachine/LICENSE +0 -506
  182. data/lib/deprec/third_party/railsmachine/recipes/apache.rb +0 -92
  183. data/lib/deprec/third_party/railsmachine/recipes/mysql.rb +0 -73
  184. data/lib/deprec/third_party/railsmachine/recipes/templates/httpd-ssl.conf +0 -80
  185. data/lib/deprec/third_party/railsmachine/recipes/templates/httpd.conf +0 -57
  186. data/lib/deprec/third_party/vmbuilder/plugins.rb +0 -8
  187. data/lib/deprec/third_party/vmbuilder/plugins/apt.rb +0 -144
  188. data/resources/capistrano_include_dotfiles.patch +0 -17
@@ -1,114 +0,0 @@
1
- Capistrano.configuration(:must_exist).load do
2
- set :vm_dir, '/var/vm'
3
- set :stemserver, 'stemserver_ubuntu_6.06.1'
4
-
5
- task :install_my_package do
6
- packages = {:base => %w{build-essential libdb2 xinetd}}
7
- packages[:base] << 'linux-headers-$(uname -r)'
8
- apt.install(packages, :stable)
9
- end
10
-
11
- task :install_vmware_server do
12
- version = 'VMware-server-1.0.1-29996'
13
- set :src_package, {
14
- :file => version + '.tar.gz',
15
- :dir => 'vmware-server-distrib',
16
- :url => "http://10.0.100.45/download/vmware/#{version}.tar.gz",
17
- :unpack => "tar zxf #{version}.tar.gz;",
18
- }
19
- # pre-requisites on Ubuntu
20
- disable_cdrom_install
21
- enable_universe
22
- packages = {:base => %w{build-essential libdb2 xinetd}}
23
- packages[:base] << 'linux-headers-$(uname -r)'
24
- apt.install(packages, :stable)
25
-
26
-
27
- # sudo apt-get install build-essential x-window-system-core
28
-
29
- deprec.download_src(src_package, src_dir)
30
- deprec.install_from_src(src_package, src_dir)
31
- puts
32
- puts "IMPORTANT"
33
- puts "manually run the following command:"
34
- puts "sudo /usr/bin/vmware-config.pl"
35
- puts
36
- end
37
-
38
- task :install_vmware_mui do
39
- version = 'VMware-mui-1.0.1-29996'
40
- src_package = {
41
- :file => version + '.tar.gz',
42
- :dir => 'vmware-mui-distrib',
43
- :url => "http://10.0.100.45/download/vmware/#{version}.tar.gz",
44
- :unpack => "tar zxf #{version}.tar.gz;",
45
- :install => './vmware-install.pl;'
46
- }
47
- deprec.download_src(src_package, src_dir)
48
- deprec.unpack_src(src_package, src_dir)
49
- # XXX work out how to do this interactive through capistrano
50
- puts
51
- puts "IMPORTANT - you need to log in and run the following commands"
52
- puts "cd /usr/local/src/vmware-server-distrib && sudo ./vmware-install.pl"
53
- puts "cd /etc/vmware/ssl/ && sudo touch rui.key rui.crt"
54
- puts "sudo /usr/bin/vmware-config.pl"
55
- puts
56
- end
57
-
58
- # # currently only for CentOS
59
- # task :install_vmware_server do
60
- # version = 'VMware-server-1.0.1-29996.i386'
61
- # set :src_package, {
62
- # :file => version + '.rpm',
63
- # :url => "http://10.0.100.45/download/vmware/#{version}.rpm",
64
- # :install => "rpm -i #{File.join(src_dir, version + '.rpm')};"
65
- # }
66
- # deprec.download_src(src_package, src_dir)
67
- # sudo src_package[:install]
68
- # sudo "yum install gcc" # when you select the develpment packages on CentOS it doesn't give you gcc!
69
- # # XXX work out how to do this interactive through capistrano
70
- # puts
71
- # puts "IMPORTANT"
72
- # puts "sudo /usr/bin/vmware-config.pl"
73
- # puts
74
- # end
75
- #
76
- # task :install_vmware_mui do
77
- # version = 'VMware-mui-1.0.1-29996'
78
- # src_package = {
79
- # :file => version + '.tar.gz',
80
- # :dir => 'vmware-mui-distrib',
81
- # :url => "http://10.0.100.45/download/vmware/#{version}.tar.gz",
82
- # :unpack => "tar zxf #{version}.tar.gz;",
83
- # :install => './vmware-install.pl;'
84
- # }
85
- # deprec.download_src(src_package, src_dir)
86
- # deprec.unpack_src(src_package, src_dir)
87
- # # XXX work out how to do this interactive through capistrano
88
- # puts
89
- # puts "IMPORTANT - you need to log in and run"
90
- # puts "cd /usr/local/src/vmware-mui-distrib && sudo ./vmware-install.pl"
91
- # puts
92
- # end
93
-
94
- task :replicate_stemserver do
95
- sudo <<-SUDO
96
- sh -c '
97
- cd #{vm_dir};
98
- test -d #{stemserver} || tar zxfv #{stemserver}.tgz;
99
- perl -pi -e 's/displayName = ".*"/displayName = "#{new_hostname}"/' stemserver/*.vmx;
100
- mv stemserver #{new_hostname};
101
- SUDO
102
- end
103
-
104
- desc "update hostname and ip address of new virtual server"
105
- task :differentiate_stemserver do
106
- #
107
-
108
- # update /etc/hostname
109
- # update /etc/hostname
110
- # update /etc/network/interfaces
111
-
112
- end
113
-
114
- end
@@ -1,106 +0,0 @@
1
- # -*- coding: utf-8 -*-
2
-
3
- [attachment]
4
- max_size = 262144
5
- render_unsafe_content = false
6
-
7
- [browser]
8
- downloadable_paths = /trunk, /branches/*, /tags/*
9
- hide_properties = svk:merge
10
- render_unsafe_content = false
11
-
12
- [changeset]
13
- max_diff_bytes = 10000000
14
- max_diff_files = 0
15
- wiki_format_messages = true
16
-
17
- [header_logo]
18
- alt =
19
- height = -1
20
- link = http://example.org/
21
- src = common/trac_banner.png
22
- width = -1
23
-
24
- [logging]
25
- log_file = trac.log
26
- # log_format = <set in global trac.ini>
27
- log_level = DEBUG
28
- log_type = none
29
-
30
- [mimeviewer]
31
- enscript_modes = text/x-dylan:dylan:4
32
- enscript_path = enscript
33
- max_preview_size = 262144
34
- mime_map = text/x-dylan:dylan,text/x-idl:ice,text/x-ada:ads:adb
35
- php_path = php
36
- silvercity_modes =
37
- tab_width = 8
38
-
39
- [notification]
40
- always_notify_owner = false
41
- always_notify_reporter = false
42
- always_notify_updater = true
43
- mime_encoding = base64
44
- smtp_always_bcc =
45
- smtp_always_cc =
46
- smtp_default_domain =
47
- smtp_enabled = <%= trac_smtp_enabled.to_s %>
48
- smtp_from = trac@localhost
49
- smtp_password =
50
- smtp_port = 25
51
- smtp_replyto = trac@localhost
52
- smtp_server = localhost
53
- smtp_subject_prefix = __default__
54
- smtp_user =
55
- use_public_cc = false
56
- use_short_addr = false
57
- use_tls = false
58
-
59
- [project]
60
- descr = My example project
61
- footer = Visit the Trac open source project at<br /><a href="http://trac.edgewall.org/">http://trac.edgewall.org/</a>
62
- icon = common/trac.ico
63
- name = <%= application %>
64
- url = http://example.org/
65
-
66
- [search]
67
- min_query_length = 3
68
-
69
- [ticket]
70
- default_component =
71
- default_milestone =
72
- default_priority = major
73
- default_type = defect
74
- default_version =
75
- restrict_owner = false
76
-
77
- [timeline]
78
- changeset_long_messages = false
79
- changeset_show_files = 0
80
- default_daysback = 30
81
- ticket_show_details = false
82
-
83
- [trac]
84
- authz_file =
85
- authz_module_name =
86
- base_url =
87
- check_auth_ip = true
88
- database = sqlite:db/trac.db
89
- default_charset = iso-8859-15
90
- default_handler = WikiModule
91
- htdocs_location =
92
- ignore_auth_case = false
93
- mainnav = wiki,timeline,roadmap,browser,tickets,newticket,search
94
- metanav = login,logout,settings,help,about
95
- permission_store = DefaultPermissionStore
96
- repository_dir = <%= repos_root %>
97
- repository_type = svn
98
- # request_filters = <set in global trac.ini>
99
- # templates_dir = <set in global trac.ini>
100
- timeout = 20
101
-
102
- [wiki]
103
- ignore_missing_pages = false
104
- render_unsafe_content = false
105
- split_page_names = false
106
-
@@ -1,12 +0,0 @@
1
- Deprec was inspired by the brilliantly executed Capistrano. Thanks Jamis!
2
-
3
- After starting on this project I found myself reading a lot of code by
4
- Bradley Taylor, in particular the RailsMachine and VMbuilder gems.
5
-
6
- Neil Wilson wrote three capistrano plugins that are used in this project.
7
-
8
- I'd like to say a huge thanks to these guys for helping make my work easier!
9
-
10
- For the first cut I have included all third party code in a directory within
11
- the deprec gem, rather than link to the gems themselves. I made this decision
12
- to prevent deprec from breaking due to a change in one of the other libraries.
@@ -1,506 +0,0 @@
1
- Copyright (c) 2006 Bradley Taylor, bradley@fluxura.com
2
-
3
- GNU LESSER GENERAL PUBLIC LICENSE
4
- Version 2.1, February 1999
5
-
6
- Copyright (C) 1991, 1999 Free Software Foundation, Inc.
7
- 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
8
- Everyone is permitted to copy and distribute verbatim copies
9
- of this license document, but changing it is not allowed.
10
-
11
- [This is the first released version of the Lesser GPL. It also counts
12
- as the successor of the GNU Library Public License, version 2, hence
13
- the version number 2.1.]
14
-
15
- Preamble
16
-
17
- The licenses for most software are designed to take away your
18
- freedom to share and change it. By contrast, the GNU General Public
19
- Licenses are intended to guarantee your freedom to share and change
20
- free software--to make sure the software is free for all its users.
21
-
22
- This license, the Lesser General Public License, applies to some
23
- specially designated software packages--typically libraries--of the
24
- Free Software Foundation and other authors who decide to use it. You
25
- can use it too, but we suggest you first think carefully about whether
26
- this license or the ordinary General Public License is the better
27
- strategy to use in any particular case, based on the explanations below.
28
-
29
- When we speak of free software, we are referring to freedom of use,
30
- not price. Our General Public Licenses are designed to make sure that
31
- you have the freedom to distribute copies of free software (and charge
32
- for this service if you wish); that you receive source code or can get
33
- it if you want it; that you can change the software and use pieces of
34
- it in new free programs; and that you are informed that you can do
35
- these things.
36
-
37
- To protect your rights, we need to make restrictions that forbid
38
- distributors to deny you these rights or to ask you to surrender these
39
- rights. These restrictions translate to certain responsibilities for
40
- you if you distribute copies of the library or if you modify it.
41
-
42
- For example, if you distribute copies of the library, whether gratis
43
- or for a fee, you must give the recipients all the rights that we gave
44
- you. You must make sure that they, too, receive or can get the source
45
- code. If you link other code with the library, you must provide
46
- complete object files to the recipients, so that they can relink them
47
- with the library after making changes to the library and recompiling
48
- it. And you must show them these terms so they know their rights.
49
-
50
- We protect your rights with a two-step method: (1) we copyright the
51
- library, and (2) we offer you this license, which gives you legal
52
- permission to copy, distribute and/or modify the library.
53
-
54
- To protect each distributor, we want to make it very clear that
55
- there is no warranty for the free library. Also, if the library is
56
- modified by someone else and passed on, the recipients should know
57
- that what they have is not the original version, so that the original
58
- author's reputation will not be affected by problems that might be
59
- introduced by others.
60
-
61
- Finally, software patents pose a constant threat to the existence of
62
- any free program. We wish to make sure that a company cannot
63
- effectively restrict the users of a free program by obtaining a
64
- restrictive license from a patent holder. Therefore, we insist that
65
- any patent license obtained for a version of the library must be
66
- consistent with the full freedom of use specified in this license.
67
-
68
- Most GNU software, including some libraries, is covered by the
69
- ordinary GNU General Public License. This license, the GNU Lesser
70
- General Public License, applies to certain designated libraries, and
71
- is quite different from the ordinary General Public License. We use
72
- this license for certain libraries in order to permit linking those
73
- libraries into non-free programs.
74
-
75
- When a program is linked with a library, whether statically or using
76
- a shared library, the combination of the two is legally speaking a
77
- combined work, a derivative of the original library. The ordinary
78
- General Public License therefore permits such linking only if the
79
- entire combination fits its criteria of freedom. The Lesser General
80
- Public License permits more lax criteria for linking other code with
81
- the library.
82
-
83
- We call this license the "Lesser" General Public License because it
84
- does Less to protect the user's freedom than the ordinary General
85
- Public License. It also provides other free software developers Less
86
- of an advantage over competing non-free programs. These disadvantages
87
- are the reason we use the ordinary General Public License for many
88
- libraries. However, the Lesser license provides advantages in certain
89
- special circumstances.
90
-
91
- For example, on rare occasions, there may be a special need to
92
- encourage the widest possible use of a certain library, so that it becomes
93
- a de-facto standard. To achieve this, non-free programs must be
94
- allowed to use the library. A more frequent case is that a free
95
- library does the same job as widely used non-free libraries. In this
96
- case, there is little to gain by limiting the free library to free
97
- software only, so we use the Lesser General Public License.
98
-
99
- In other cases, permission to use a particular library in non-free
100
- programs enables a greater number of people to use a large body of
101
- free software. For example, permission to use the GNU C Library in
102
- non-free programs enables many more people to use the whole GNU
103
- operating system, as well as its variant, the GNU/Linux operating
104
- system.
105
-
106
- Although the Lesser General Public License is Less protective of the
107
- users' freedom, it does ensure that the user of a program that is
108
- linked with the Library has the freedom and the wherewithal to run
109
- that program using a modified version of the Library.
110
-
111
- The precise terms and conditions for copying, distribution and
112
- modification follow. Pay close attention to the difference between a
113
- "work based on the library" and a "work that uses the library". The
114
- former contains code derived from the library, whereas the latter must
115
- be combined with the library in order to run.
116
-
117
- GNU LESSER GENERAL PUBLIC LICENSE
118
- TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
119
-
120
- 0. This License Agreement applies to any software library or other
121
- program which contains a notice placed by the copyright holder or
122
- other authorized party saying it may be distributed under the terms of
123
- this Lesser General Public License (also called "this License").
124
- Each licensee is addressed as "you".
125
-
126
- A "library" means a collection of software functions and/or data
127
- prepared so as to be conveniently linked with application programs
128
- (which use some of those functions and data) to form executables.
129
-
130
- The "Library", below, refers to any such software library or work
131
- which has been distributed under these terms. A "work based on the
132
- Library" means either the Library or any derivative work under
133
- copyright law: that is to say, a work containing the Library or a
134
- portion of it, either verbatim or with modifications and/or translated
135
- straightforwardly into another language. (Hereinafter, translation is
136
- included without limitation in the term "modification".)
137
-
138
- "Source code" for a work means the preferred form of the work for
139
- making modifications to it. For a library, complete source code means
140
- all the source code for all modules it contains, plus any associated
141
- interface definition files, plus the scripts used to control compilation
142
- and installation of the library.
143
-
144
- Activities other than copying, distribution and modification are not
145
- covered by this License; they are outside its scope. The act of
146
- running a program using the Library is not restricted, and output from
147
- such a program is covered only if its contents constitute a work based
148
- on the Library (independent of the use of the Library in a tool for
149
- writing it). Whether that is true depends on what the Library does
150
- and what the program that uses the Library does.
151
-
152
- 1. You may copy and distribute verbatim copies of the Library's
153
- complete source code as you receive it, in any medium, provided that
154
- you conspicuously and appropriately publish on each copy an
155
- appropriate copyright notice and disclaimer of warranty; keep intact
156
- all the notices that refer to this License and to the absence of any
157
- warranty; and distribute a copy of this License along with the
158
- Library.
159
-
160
- You may charge a fee for the physical act of transferring a copy,
161
- and you may at your option offer warranty protection in exchange for a
162
- fee.
163
-
164
- 2. You may modify your copy or copies of the Library or any portion
165
- of it, thus forming a work based on the Library, and copy and
166
- distribute such modifications or work under the terms of Section 1
167
- above, provided that you also meet all of these conditions:
168
-
169
- a) The modified work must itself be a software library.
170
-
171
- b) You must cause the files modified to carry prominent notices
172
- stating that you changed the files and the date of any change.
173
-
174
- c) You must cause the whole of the work to be licensed at no
175
- charge to all third parties under the terms of this License.
176
-
177
- d) If a facility in the modified Library refers to a function or a
178
- table of data to be supplied by an application program that uses
179
- the facility, other than as an argument passed when the facility
180
- is invoked, then you must make a good faith effort to ensure that,
181
- in the event an application does not supply such function or
182
- table, the facility still operates, and performs whatever part of
183
- its purpose remains meaningful.
184
-
185
- (For example, a function in a library to compute square roots has
186
- a purpose that is entirely well-defined independent of the
187
- application. Therefore, Subsection 2d requires that any
188
- application-supplied function or table used by this function must
189
- be optional: if the application does not supply it, the square
190
- root function must still compute square roots.)
191
-
192
- These requirements apply to the modified work as a whole. If
193
- identifiable sections of that work are not derived from the Library,
194
- and can be reasonably considered independent and separate works in
195
- themselves, then this License, and its terms, do not apply to those
196
- sections when you distribute them as separate works. But when you
197
- distribute the same sections as part of a whole which is a work based
198
- on the Library, the distribution of the whole must be on the terms of
199
- this License, whose permissions for other licensees extend to the
200
- entire whole, and thus to each and every part regardless of who wrote
201
- it.
202
-
203
- Thus, it is not the intent of this section to claim rights or contest
204
- your rights to work written entirely by you; rather, the intent is to
205
- exercise the right to control the distribution of derivative or
206
- collective works based on the Library.
207
-
208
- In addition, mere aggregation of another work not based on the Library
209
- with the Library (or with a work based on the Library) on a volume of
210
- a storage or distribution medium does not bring the other work under
211
- the scope of this License.
212
-
213
- 3. You may opt to apply the terms of the ordinary GNU General Public
214
- License instead of this License to a given copy of the Library. To do
215
- this, you must alter all the notices that refer to this License, so
216
- that they refer to the ordinary GNU General Public License, version 2,
217
- instead of to this License. (If a newer version than version 2 of the
218
- ordinary GNU General Public License has appeared, then you can specify
219
- that version instead if you wish.) Do not make any other change in
220
- these notices.
221
-
222
- Once this change is made in a given copy, it is irreversible for
223
- that copy, so the ordinary GNU General Public License applies to all
224
- subsequent copies and derivative works made from that copy.
225
-
226
- This option is useful when you wish to copy part of the code of
227
- the Library into a program that is not a library.
228
-
229
- 4. You may copy and distribute the Library (or a portion or
230
- derivative of it, under Section 2) in object code or executable form
231
- under the terms of Sections 1 and 2 above provided that you accompany
232
- it with the complete corresponding machine-readable source code, which
233
- must be distributed under the terms of Sections 1 and 2 above on a
234
- medium customarily used for software interchange.
235
-
236
- If distribution of object code is made by offering access to copy
237
- from a designated place, then offering equivalent access to copy the
238
- source code from the same place satisfies the requirement to
239
- distribute the source code, even though third parties are not
240
- compelled to copy the source along with the object code.
241
-
242
- 5. A program that contains no derivative of any portion of the
243
- Library, but is designed to work with the Library by being compiled or
244
- linked with it, is called a "work that uses the Library". Such a
245
- work, in isolation, is not a derivative work of the Library, and
246
- therefore falls outside the scope of this License.
247
-
248
- However, linking a "work that uses the Library" with the Library
249
- creates an executable that is a derivative of the Library (because it
250
- contains portions of the Library), rather than a "work that uses the
251
- library". The executable is therefore covered by this License.
252
- Section 6 states terms for distribution of such executables.
253
-
254
- When a "work that uses the Library" uses material from a header file
255
- that is part of the Library, the object code for the work may be a
256
- derivative work of the Library even though the source code is not.
257
- Whether this is true is especially significant if the work can be
258
- linked without the Library, or if the work is itself a library. The
259
- threshold for this to be true is not precisely defined by law.
260
-
261
- If such an object file uses only numerical parameters, data
262
- structure layouts and accessors, and small macros and small inline
263
- functions (ten lines or less in length), then the use of the object
264
- file is unrestricted, regardless of whether it is legally a derivative
265
- work. (Executables containing this object code plus portions of the
266
- Library will still fall under Section 6.)
267
-
268
- Otherwise, if the work is a derivative of the Library, you may
269
- distribute the object code for the work under the terms of Section 6.
270
- Any executables containing that work also fall under Section 6,
271
- whether or not they are linked directly with the Library itself.
272
-
273
- 6. As an exception to the Sections above, you may also combine or
274
- link a "work that uses the Library" with the Library to produce a
275
- work containing portions of the Library, and distribute that work
276
- under terms of your choice, provided that the terms permit
277
- modification of the work for the customer's own use and reverse
278
- engineering for debugging such modifications.
279
-
280
- You must give prominent notice with each copy of the work that the
281
- Library is used in it and that the Library and its use are covered by
282
- this License. You must supply a copy of this License. If the work
283
- during execution displays copyright notices, you must include the
284
- copyright notice for the Library among them, as well as a reference
285
- directing the user to the copy of this License. Also, you must do one
286
- of these things:
287
-
288
- a) Accompany the work with the complete corresponding
289
- machine-readable source code for the Library including whatever
290
- changes were used in the work (which must be distributed under
291
- Sections 1 and 2 above); and, if the work is an executable linked
292
- with the Library, with the complete machine-readable "work that
293
- uses the Library", as object code and/or source code, so that the
294
- user can modify the Library and then relink to produce a modified
295
- executable containing the modified Library. (It is understood
296
- that the user who changes the contents of definitions files in the
297
- Library will not necessarily be able to recompile the application
298
- to use the modified definitions.)
299
-
300
- b) Use a suitable shared library mechanism for linking with the
301
- Library. A suitable mechanism is one that (1) uses at run time a
302
- copy of the library already present on the user's computer system,
303
- rather than copying library functions into the executable, and (2)
304
- will operate properly with a modified version of the library, if
305
- the user installs one, as long as the modified version is
306
- interface-compatible with the version that the work was made with.
307
-
308
- c) Accompany the work with a written offer, valid for at
309
- least three years, to give the same user the materials
310
- specified in Subsection 6a, above, for a charge no more
311
- than the cost of performing this distribution.
312
-
313
- d) If distribution of the work is made by offering access to copy
314
- from a designated place, offer equivalent access to copy the above
315
- specified materials from the same place.
316
-
317
- e) Verify that the user has already received a copy of these
318
- materials or that you have already sent this user a copy.
319
-
320
- For an executable, the required form of the "work that uses the
321
- Library" must include any data and utility programs needed for
322
- reproducing the executable from it. However, as a special exception,
323
- the materials to be distributed need not include anything that is
324
- normally distributed (in either source or binary form) with the major
325
- components (compiler, kernel, and so on) of the operating system on
326
- which the executable runs, unless that component itself accompanies
327
- the executable.
328
-
329
- It may happen that this requirement contradicts the license
330
- restrictions of other proprietary libraries that do not normally
331
- accompany the operating system. Such a contradiction means you cannot
332
- use both them and the Library together in an executable that you
333
- distribute.
334
-
335
- 7. You may place library facilities that are a work based on the
336
- Library side-by-side in a single library together with other library
337
- facilities not covered by this License, and distribute such a combined
338
- library, provided that the separate distribution of the work based on
339
- the Library and of the other library facilities is otherwise
340
- permitted, and provided that you do these two things:
341
-
342
- a) Accompany the combined library with a copy of the same work
343
- based on the Library, uncombined with any other library
344
- facilities. This must be distributed under the terms of the
345
- Sections above.
346
-
347
- b) Give prominent notice with the combined library of the fact
348
- that part of it is a work based on the Library, and explaining
349
- where to find the accompanying uncombined form of the same work.
350
-
351
- 8. You may not copy, modify, sublicense, link with, or distribute
352
- the Library except as expressly provided under this License. Any
353
- attempt otherwise to copy, modify, sublicense, link with, or
354
- distribute the Library is void, and will automatically terminate your
355
- rights under this License. However, parties who have received copies,
356
- or rights, from you under this License will not have their licenses
357
- terminated so long as such parties remain in full compliance.
358
-
359
- 9. You are not required to accept this License, since you have not
360
- signed it. However, nothing else grants you permission to modify or
361
- distribute the Library or its derivative works. These actions are
362
- prohibited by law if you do not accept this License. Therefore, by
363
- modifying or distributing the Library (or any work based on the
364
- Library), you indicate your acceptance of this License to do so, and
365
- all its terms and conditions for copying, distributing or modifying
366
- the Library or works based on it.
367
-
368
- 10. Each time you redistribute the Library (or any work based on the
369
- Library), the recipient automatically receives a license from the
370
- original licensor to copy, distribute, link with or modify the Library
371
- subject to these terms and conditions. You may not impose any further
372
- restrictions on the recipients' exercise of the rights granted herein.
373
- You are not responsible for enforcing compliance by third parties with
374
- this License.
375
-
376
- 11. If, as a consequence of a court judgment or allegation of patent
377
- infringement or for any other reason (not limited to patent issues),
378
- conditions are imposed on you (whether by court order, agreement or
379
- otherwise) that contradict the conditions of this License, they do not
380
- excuse you from the conditions of this License. If you cannot
381
- distribute so as to satisfy simultaneously your obligations under this
382
- License and any other pertinent obligations, then as a consequence you
383
- may not distribute the Library at all. For example, if a patent
384
- license would not permit royalty-free redistribution of the Library by
385
- all those who receive copies directly or indirectly through you, then
386
- the only way you could satisfy both it and this License would be to
387
- refrain entirely from distribution of the Library.
388
-
389
- If any portion of this section is held invalid or unenforceable under any
390
- particular circumstance, the balance of the section is intended to apply,
391
- and the section as a whole is intended to apply in other circumstances.
392
-
393
- It is not the purpose of this section to induce you to infringe any
394
- patents or other property right claims or to contest validity of any
395
- such claims; this section has the sole purpose of protecting the
396
- integrity of the free software distribution system which is
397
- implemented by public license practices. Many people have made
398
- generous contributions to the wide range of software distributed
399
- through that system in reliance on consistent application of that
400
- system; it is up to the author/donor to decide if he or she is willing
401
- to distribute software through any other system and a licensee cannot
402
- impose that choice.
403
-
404
- This section is intended to make thoroughly clear what is believed to
405
- be a consequence of the rest of this License.
406
-
407
- 12. If the distribution and/or use of the Library is restricted in
408
- certain countries either by patents or by copyrighted interfaces, the
409
- original copyright holder who places the Library under this License may add
410
- an explicit geographical distribution limitation excluding those countries,
411
- so that distribution is permitted only in or among countries not thus
412
- excluded. In such case, this License incorporates the limitation as if
413
- written in the body of this License.
414
-
415
- 13. The Free Software Foundation may publish revised and/or new
416
- versions of the Lesser General Public License from time to time.
417
- Such new versions will be similar in spirit to the present version,
418
- but may differ in detail to address new problems or concerns.
419
-
420
- Each version is given a distinguishing version number. If the Library
421
- specifies a version number of this License which applies to it and
422
- "any later version", you have the option of following the terms and
423
- conditions either of that version or of any later version published by
424
- the Free Software Foundation. If the Library does not specify a
425
- license version number, you may choose any version ever published by
426
- the Free Software Foundation.
427
-
428
- 14. If you wish to incorporate parts of the Library into other free
429
- programs whose distribution conditions are incompatible with these,
430
- write to the author to ask for permission. For software which is
431
- copyrighted by the Free Software Foundation, write to the Free
432
- Software Foundation; we sometimes make exceptions for this. Our
433
- decision will be guided by the two goals of preserving the free status
434
- of all derivatives of our free software and of promoting the sharing
435
- and reuse of software generally.
436
-
437
- NO WARRANTY
438
-
439
- 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
440
- WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
441
- EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
442
- OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
443
- KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
444
- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
445
- PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
446
- LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
447
- THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
448
-
449
- 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
450
- WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
451
- AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
452
- FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
453
- CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
454
- LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
455
- RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
456
- FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
457
- SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
458
- DAMAGES.
459
-
460
- END OF TERMS AND CONDITIONS
461
-
462
- How to Apply These Terms to Your New Libraries
463
-
464
- If you develop a new library, and you want it to be of the greatest
465
- possible use to the public, we recommend making it free software that
466
- everyone can redistribute and change. You can do so by permitting
467
- redistribution under these terms (or, alternatively, under the terms of the
468
- ordinary General Public License).
469
-
470
- To apply these terms, attach the following notices to the library. It is
471
- safest to attach them to the start of each source file to most effectively
472
- convey the exclusion of warranty; and each file should have at least the
473
- "copyright" line and a pointer to where the full notice is found.
474
-
475
- <one line to give the library's name and a brief idea of what it does.>
476
- Copyright (C) <year> <name of author>
477
-
478
- This library is free software; you can redistribute it and/or
479
- modify it under the terms of the GNU Lesser General Public
480
- License as published by the Free Software Foundation; either
481
- version 2.1 of the License, or (at your option) any later version.
482
-
483
- This library is distributed in the hope that it will be useful,
484
- but WITHOUT ANY WARRANTY; without even the implied warranty of
485
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
486
- Lesser General Public License for more details.
487
-
488
- You should have received a copy of the GNU Lesser General Public
489
- License along with this library; if not, write to the Free Software
490
- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
491
-
492
- Also add information on how to contact you by electronic and paper mail.
493
-
494
- You should also get your employer (if you work as a programmer) or your
495
- school, if any, to sign a "copyright disclaimer" for the library, if
496
- necessary. Here is a sample; alter the names:
497
-
498
- Yoyodyne, Inc., hereby disclaims all copyright interest in the
499
- library `Frob' (a library for tweaking knobs) written by James Random Hacker.
500
-
501
- <signature of Ty Coon>, 1 April 1990
502
- Ty Coon, President of Vice
503
-
504
- That's all there is to it!
505
-
506
-