--- /dev/null
+puma (4.3.1-1)
+
+ Several tests have been disabled by default:
+
+ - test/test_puma_server_ssl.rb has been disabled because all tests fail
+ randomly. However these tests have never been performed in puma 3.x and
+ they also work randomly. So until someone can look into them and fix them,
+ we decided to not run them (see also #921931).
+
+ - test_control_for_ssl (test/test_cli.rb) and
+ test_control_ssl (test/test_pumactl.rb) show similar issues and don't seem
+ to imply that the package fails to work. So they have been disabled too.
+
+ -- Daniel Leidert <dleidert@debian.org> Wed, 05 Feb 2020 23:51:51 +0100
--- /dev/null
+puma (5.5.2-2+rpi1) bookworm-staging; urgency=medium
+
+ * Be more agressive about forcing UTF-8 locale.
+ * Fix clean target
+ * Disable testsuite
+
+ -- Peter Michael Green <plugwash@raspbian.org> Thu, 09 Dec 2021 21:50:38 +0000
+
+puma (5.5.2-2) unstable; urgency=medium
+
+ * Team upload
+ * debian/rules: force an UTF-8 locale
+ * debian/ruby-tests.rake: wrap lines
+ * debian/ruby-tests.rake: run all ssl tests on autopkgtest only
+ * debian/test/control: give ssl test a name
+
+ -- Antonio Terceiro <terceiro@debian.org> Tue, 02 Nov 2021 16:35:12 -0300
+
+puma (5.5.2-1) unstable; urgency=medium
+
+ * Team upload
+ * New upstream version 5.5.2
+ - Builds and tests fine again (Closes: #998295)
+ * Add build-dependency on ruby-localhost
+ * debian/rules: exclude several unnecessary files from installation
+
+ -- Antonio Terceiro <terceiro@debian.org> Tue, 02 Nov 2021 14:39:10 -0300
+
+puma (5.3.2-3) unstable; urgency=medium
+
+ * Use --gem-install layout option of dh-ruby
+
+ -- Pirate Praveen <praveen@debian.org> Tue, 12 Oct 2021 02:24:33 +0530
+
+puma (5.3.2-2) unstable; urgency=medium
+
+ * Reupload to unstable
+ * Bump Standards-Version to 4.6.0 (no changes needed)
+ * Bump debhelper compatibility level to 13
+
+ -- Pirate Praveen <praveen@debian.org> Mon, 11 Oct 2021 03:17:23 +0530
+
+puma (5.3.2-1) experimental; urgency=medium
+
+ * New upstream version 5.3.2 (Closes: #989054) (Fixes: CVE-2021-29509)
+ * Refresh patches
+
+ -- Pirate Praveen <praveen@debian.org> Fri, 28 May 2021 22:34:53 +0530
+
+puma (4.3.8-1) unstable; urgency=medium
+
+ * New upstream version 4.3.8 (Closes: #989054) (Fixes: CVE-2021-29509)
+
+ -- Pirate Praveen <praveen@debian.org> Wed, 26 May 2021 10:24:19 +0530
+
+puma (5.2.2-2) experimental; urgency=medium
+
+ * Disable test that failied on amd64 buildd
+
+ -- Pirate Praveen <praveen@debian.org> Mon, 08 Mar 2021 23:03:52 +0530
+
+puma (5.2.2-1) experimental; urgency=medium
+
+ * New upstream version 5.2.2
+ * Bump Standards-Version to 4.5.1 (no changes needed)
+ * Refresh patches for new upstream release
+ * Add ruby-minitest-stub-const as build dependency
+ * Disable failing tests
+
+ -- Pirate Praveen <praveen@debian.org> Sun, 07 Mar 2021 21:03:52 +0530
+
+puma (4.3.6-1) unstable; urgency=medium
+
+ * Team upload.
+ * New upstream version.
+ - Fixes CVE-2020-11076 and CVE-2020-11077 (closes: #972102).
+ * d/copyright: Minor update.
+ * d/puma.lintian-overrides: Add package override.
+ * d/ruby-tests.rake: Add logic to run SSL test.
+ * d/patches/*.patch: Add missing headers and refresh.
+ * d/source/lintian-overrides: Add source override.
+ * d/tests/control: Set environment variable to run the SSL tests separately
+ (similar to the solution used in the jekyll package).
+ * d/tests/test-puma-server-ssl*: Removed.
+
+ -- Daniel Leidert <dleidert@debian.org> Thu, 15 Oct 2020 20:57:29 +0200
+
+puma (4.3.3-3) unstable; urgency=medium
+
+ * Include patch from gitlab to improve performance
+
+ -- Pirate Praveen <praveen@debian.org> Tue, 18 Aug 2020 00:15:20 +0530
+
+puma (4.3.3-2) unstable; urgency=medium
+
+ [ Daniel Leidert ]
+ * debian/tests/test_puma_server_ssl,
+ debian/tests/test_puma_server_ssl.rake: Run test/test_puma_server_ssl.rb
+ in an openssl enviroment not using the Debian defaults.
+ * debian/tests/control: Add new test.
+
+ [ Debian Janitor ]
+ * Set field Upstream-Contact in debian/copyright.
+ * Remove obsolete fields Contact, Name from debian/upstream/metadata
+ (already present in machine-readable debian/copyright).
+
+ [ Pirate Praveen ]
+ * Remove debian-branch option from debian/gbp.conf
+ * Reupload to unstable
+
+ -- Pirate Praveen <praveen@debian.org> Mon, 03 Aug 2020 15:37:16 +0530
+
+puma (4.3.3-1) experimental; urgency=medium
+
+ * Team upload.
+ * New upstream release.
+ - Fixes CVE-2020-5247 (closes: #952766).
+ - Fixes CVE-2020-5249 (closes: #953122).
+ * d/control (Section): Change to web.
+ (Vcs-Git): Indicate branch name via -b debian/experimental.
+ (Homepage): Use secure URL.
+ (Depends): Use ${ruby:Depends}.
+ * d/copyright (Source): Use secure URL.
+ * d/rules: Add override to install upstream changelog.
+ * d/watch: Use package name for tarball.
+
+ -- Daniel Leidert <dleidert@debian.org> Thu, 05 Mar 2020 01:34:17 +0100
+
+puma (4.3.1-1) experimental; urgency=medium
+
+ * Team upload.
+ * New upstream release
+ - Fixes CVE-2019-16770 Keepalive thread overload/DoS (closes: #946312).
+ * d/control (Rules-Requires-Root): Set to binary-targets.
+ (Build-Depends, Depends): Add ruby-nio4r.
+ (Build-Depends): Add curl for test/test_integration_single.rb.
+ * d/ruby-tests.rake: Disable test/test_puma_server_ssl.rb.
+ * d/README.source: Add to explain tests which have been disabled.
+ * d/patches/0004-puma.gemspec-drop-git-usage.patch: Refresh patch.
+ * d/patches/0011-disable-minitest-extensions.patch: Add patch.
+ - Disable unavailable minitest extensions (retry and proveit).
+ * d/patches/0012-disable-cli-ssl-tests.patch: Add patch.
+ - Disable CLI SSL tests.
+ * d/patches/0013-fix-test-term-not-accepts-new-connections.patch: Add.
+ - Fix test_term_not_accepts_new_connections to be locale independent.
+ * d/patches/0002-test_integration-disable-test-that-fails-randomly.patch,
+ d/patches/0003-test_cli-disable-test-that-rails-randomly.patch,
+ d/patches/0005-test_puma_server-disable-test-that-fails-randomly.patch,
+ d/patches/0006-test-helper.rb-drop-bundler-usage.patch,
+ d/patches/0007-test-test_cli.rb-disable-test-that-fails-randomly.patch,
+ d/patches/0008-fix-ssl-tests.patch,
+ d/patches/0009-disable-tests-failing-in-single-cpu.patch,
+ d/patches/0010-fix-cluster-exit-for-ruby27.patch: Remove obsolete patches.
+ * d/patches/series: Adjust.
+
+ -- Daniel Leidert <dleidert@debian.org> Thu, 06 Feb 2020 11:45:11 +0100
+
+puma (3.12.4-1) unstable; urgency=medium
+
+ * Team upload.
+ * New upstream release.
+ - Fixes CVE-2020-5247 (closes: #952766).
+ - Fixes CVE-2020-5249 (closes: #953122).
+ * d/control (Section): Changed to web.
+ (Homepage): Use secure URL.
+ (Depends): Add ${ruby:Depends}.
+ * d/copyright (Source): Use secure URL.
+ * d/ruby-tests.rake: Disable test/test_puma_server_ssl.rb for the moment.
+ These tests fail due to openssl being configured to use SECLEVEL2
+ (https://github.com/puma/puma/issues/2147).
+ * d/rules: Add override to install upstream changelog.
+ * d/watch: Rename downloaded tarball to include package name.
+ * d/patches/0008-fix-ssl-tests.patch: Remove patch. Applied upstream.
+ * d/patches/CVE-2019-16770.patch: Ditto.
+ * d/patches/*.patch: Refresh patches.
+ * d/patches/series: Adjust.
+
+ -- Daniel Leidert <dleidert@debian.org> Wed, 04 Mar 2020 23:09:16 +0100
+
+puma (3.12.0-4) unstable; urgency=medium
+
+ * Team upload.
+ * d/control (Rules-Requires-Root): Set to binary-targets.
+ * d/patches/0011-disable-minitest-extensions.patch: Add patch.
+ - Disable unavailable minitest retry extension.
+ * d/patches/CVE-2019-16770.patch: Add patch.
+ - Backport fix for CVE-2019-16770 from upstream (closes: #946312).
+ * d/patches/series: Add patch.
+
+ -- Daniel Leidert <dleidert@debian.org> Thu, 06 Feb 2020 12:54:59 +0100
+
+puma (3.12.0-3) unstable; urgency=medium
+
+ * Team upload.
+ * d/compat: Remove obsolete file.
+ * d/control: Add Rules-Requires-Root field.
+ (Build-Depends): Use debhelper-compat.
+ (Standards-Version): Bump to 4.5.0.
+ (Depends): Drop ruby-interpreter.
+ * d/copyright (Format): Fix insecure-copyright-format-uri and add myself.
+ * d/puma.1, d/pumactl.1: Add manual pages.
+ * d/puma.manpages: Install manual pages.
+ * d/ruby-tests.rake: Set verbose mode.
+ * d/patches/0010-fix-cluster-exit-for-ruby27.patch: Add patch.
+ - Fix hang with Ruby >= 2.6 when shutting down workers.
+ * d/patches/series: Enable new patch.
+ * d/upstream/metadata: Add metadata.
+ * d/upstream/metadata: Add metadata.
+
+ -- Daniel Leidert <dleidert@debian.org> Wed, 05 Feb 2020 18:20:58 +0100
+
+puma (3.12.0-2) unstable; urgency=medium
+
+ * Disable tests failing in single cpu (Closes: #921931)
+
+ -- Pirate Praveen <praveen@debian.org> Sun, 10 Feb 2019 18:56:47 +0530
+
+puma (3.12.0-1) unstable; urgency=medium
+
+ [ Balint Reczey ]
+ * New upstream version 3.12.0
+ * Refresh patches
+
+ [ Pirate Praveen ]
+ * Fix OpenSSL 1.1.1 test failures with upstream patch (Closes: #900156)
+ * Bump Standards-Version to 4.3.0 (no changes needed)
+ * Add myself to uploaders
+
+ -- Pirate Praveen <praveen@debian.org> Sun, 10 Feb 2019 10:56:59 +0530
+
+puma (3.11.3-1) unstable; urgency=medium
+
+ * Team upload
+ * Remove myself from Uploaders:
+ * New upstream version 3.11.3
+ * Build against libssl-dev instead of libssl1.0-dev (Closes: #859542)
+ * Refresh packaging files with `dh-make-ruby -wo .`
+ * Bump debhelper compat to 11
+ * Change Vcs-* to point to salsa.debian.org
+ * Use standard debian/ruby-tests.rake
+ * drop build-dependency on ruby-hoe
+ * Refresh patches
+ * New patches:
+ - 0006-test-helper.rb-drop-bundler-usage.patch
+ - 0007-test-test_cli.rb-disable-test-that-fails-randomly.patch
+ * Replace 0001-test_puma_server_ssl-update-for-newer-versions-of-Op.patch
+ with 0001-test_puma_server_ssl-disable-test-that-takes-too-lon.patch
+
+
+ -- Antonio Terceiro <terceiro@debian.org> Wed, 28 Mar 2018 18:53:22 -0300
+
+puma (3.6.0-1) unstable; urgency=medium
+
+ * Initial release (Closes: #720336)
+
+ -- Antonio Terceiro <terceiro@debian.org> Thu, 10 Nov 2016 16:47:06 -0200
--- /dev/null
+Source: puma
+Section: web
+Priority: optional
+Maintainer: Debian Ruby Team <pkg-ruby-extras-maintainers@lists.alioth.debian.org>
+Uploaders: Pirate Praveen <praveen@debian.org>
+Build-Depends: curl,
+ debhelper-compat (= 13),
+ gem2deb (>= 1.6),
+ libssl-dev,
+ rake,
+ ruby-localhost,
+ ruby-nio4r (>= 2),
+ ruby-rack (<< 3),
+ ruby-minitest-stub-const
+Standards-Version: 4.6.0
+Vcs-Git: https://salsa.debian.org/ruby-team/puma.git -b debian/experimental
+Vcs-Browser: https://salsa.debian.org/ruby-team/puma
+Homepage: https://puma.io
+Testsuite: autopkgtest-pkg-ruby
+XS-Ruby-Versions: all
+Rules-Requires-Root: binary-targets
+
+Package: puma
+Architecture: any
+XB-Ruby-Versions: ${ruby:Versions}
+Depends: ruby, ${misc:Depends}, ${ruby:Depends}, ${shlibs:Depends}
+Description: threaded HTTP 1.1 server for Ruby/Rack applications
+ Puma is a simple, fast, threaded, and highly concurrent HTTP 1.1 server for
+ Ruby/Rack applications. Puma is intended for use in both development and
+ production environments.
--- /dev/null
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: puma
+Upstream-Contact: https://github.com/puma/puma/issues
+Source: https://github.com/puma/puma
+
+Files: *
+Copyright: 2005, Zed Shaw
+ 2011, Evan Phoenix
+License: BSD-3-clause
+
+Files: debian/*
+Copyright: 2016 Antonio Terceiro <terceiro@debian.org>
+ 2020 Daniel Leidert <dleidert@debian.org>
+License: BSD-3-clause
+Comment: The Debian packaging is licensed under the same terms as the source.
+
+License: BSD-3-clause
+ All rights reserved.
+ .
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+ .
+ * Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright notice
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+ * Neither the name of the Evan Phoenix nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
+ .
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
--- /dev/null
+From: Antonio Terceiro <terceiro@softwarelivre.org>
+Date: Wed, 5 Feb 2020 21:36:05 +0100
+Subject: Drop git usage from gemspec
+
+Forwarded: not-needed
+---
+ puma.gemspec | 3 +--
+ 1 file changed, 1 insertion(+), 2 deletions(-)
+
+--- a/puma.gemspec
++++ b/puma.gemspec
+@@ -13,8 +13,7 @@
+ if RbConfig::CONFIG['ruby_version'] >= '2.5'
+ s.metadata["msys2_mingw_dependencies"] = "openssl"
+ end
+- s.files = `git ls-files -- bin docs ext lib tools`.split("\n") +
+- %w[History.md LICENSE README.md]
++ s.files = Dir.glob('**/*').reject { |f| f =~ /^debian\//}
+ s.homepage = "https://puma.io"
+
+ if s.respond_to?(:metadata=)
--- /dev/null
+From: Daniel Leidert <daniel.leidert@wgdd.de>
+Date: Wed, 5 Feb 2020 22:20:42 +0100
+Subject: Disable unavailable minitest extensions
+
+Forwarded: not-needed
+---
+ test/helper.rb | 8 ++++----
+ 1 file changed, 4 insertions(+), 4 deletions(-)
+
+--- a/test/helper.rb
++++ b/test/helper.rb
+@@ -14,7 +14,6 @@
+ require_relative "minitest/verbose"
+ require "minitest/autorun"
+ require "minitest/pride"
+-require "minitest/proveit"
+ require "minitest/stub_const"
+ require "net/http"
+ require_relative "helpers/apps"
+@@ -84,10 +83,6 @@
+ end
+
+ Minitest::Test.prepend TimeoutEveryTestCase
+-if ENV['CI']
+- require 'minitest/retry'
+- Minitest::Retry.use!
+-end
+
+ module TestSkips
+
+@@ -157,7 +152,7 @@
+
+ class Minitest::Test
+ def self.run(reporter, options = {}) # :nodoc:
+- prove_it!
++ #prove_it!
+ super
+ end
+
--- /dev/null
+From: Daniel Leidert <daniel.leidert@wgdd.de>
+Date: Wed, 5 Feb 2020 23:18:37 +0100
+Subject: Disable cli ssl tests
+
+Forwarded: not-needed
+---
+ test/test_cli.rb | 2 +-
+ test/test_pumactl.rb | 2 +-
+ 2 files changed, 2 insertions(+), 2 deletions(-)
+
+--- a/test/test_pumactl.rb
++++ b/test/test_pumactl.rb
+@@ -149,7 +149,7 @@
+ assert_kind_of Thread, t.join, "server didn't stop"
+ end
+
+- def test_control_ssl
++ def __test_control_ssl
+ skip_unless :ssl
+
+ host = "127.0.0.1"
--- /dev/null
+From: Daniel Leidert <daniel.leidert@wgdd.de>
+Date: Thu, 6 Feb 2020 11:24:24 +0100
+Subject: Fix test to read output locale independent
+
+The test fails if run in a non-English environment.
+---
+ test/test_integration_single.rb | 2 +-
+ 1 file changed, 1 insertion(+), 1 deletion(-)
+
+--- a/test/test_integration_single.rb
++++ b/test/test_integration_single.rb
+@@ -76,7 +76,7 @@
+ true while @server.gets !~ /Gracefully stopping/ # wait for server to begin graceful shutdown
+
+ # Invoke a request which must be rejected
+- _stdin, _stdout, rejected_curl_stderr, rejected_curl_wait_thread = Open3.popen3("curl #{HOST}:#{@tcp_port}")
++ _stdin, _stdout, rejected_curl_stderr, rejected_curl_wait_thread = Open3.popen3({ "LC_ALL" => "C" }, "curl http://#{HOST}:#{@tcp_port}")
+
+ assert nil != Process.getpgid(@server.pid) # ensure server is still running
+ assert nil != Process.getpgid(curl_wait_thread[:pid]) # ensure first curl invocation still in progress
--- /dev/null
+This test failed on amd64 buildd
+https://buildd.debian.org/status/fetch.php?pkg=puma&arch=amd64&ver=5.2.2-1&stamp=1615133735&raw=0
+
+--- a/test/test_puma_server.rb
++++ b/test/test_puma_server.rb
+@@ -1261,7 +1261,7 @@
+ end
+ end
+
+- def test_command_ignored_before_run
++ def __test_command_ignored_before_run
+ @server.stop # ignored
+ @server.run
+ @server.halt
--- /dev/null
+0004-puma.gemspec-drop-git-usage.patch
+0011-disable-minitest-extensions.patch
+0012-disable-cli-ssl-tests.patch
+0013-fix-test-term-not-accepts-new-connections.patch
+0014-disable-test-failing-on-amd64.patch
--- /dev/null
+.TH PUMA "1" "January 2020" "PUMA 3.12" "User Commands"
+
+.SH NAME
+puma \- fast, concurrent web server for ruby and rack
+
+.SH USAGE
+.BI "puma [options...]" " [rackup file]"
+.PP
+.B puma [\-h | \-\-help | \-V | \-\-version]
+
+.SH OPTIONS
+.PP
+The following options are available:
+.TP
+.BI "\-b, \-\-bind " URI
+URI to bind to (tcp://, unix://, ssl://).
+.TP
+.BI "\-C, \-\-config " PATH
+Load given path as a config file.
+.TP
+.BI "\-\-control " URL
+DEPRECATED alias for \fB\-\-control\-url\fR.
+.TP
+.BI "\-\-control\-token " TOKEN
+The \fITOKEN\fR to use as authentication for the control server.
+.TP
+.BI "\-\-control\-url " URL
+The bind \fIURL\fR to use for the control server and app. Use \fIauto\fR to
+use a temp unix server. This requires to use a \fB\-\-control\-token\fR, which
+needs to be given with every request to the control server (\fItoken=foo\fR).
+.TP
+.B \-d, \-\-daemon
+Demonize the server into the background.
+.TP
+.B \-\-debug
+Show low level debugging information.
+.TP
+.BI "\-\-dir " DIR
+Change to given directory before starting.
+.TP
+.BI "\-e, \-\-environment " ENVIRONMENT
+The environment to run the Rack app on. Default \fIdevelopment\fR.
+.TP
+.BI "\-I, \-\-include " PATH
+Specify \fB$LOAD_PATH\fR directories.
+.TP
+.BI "\-p, \-\-port " PORT
+Define the TCP port to bind to. Use \fB\-b\fR for more advanced options.
+.TP
+.BI "\-\-pidfile " PATH
+Use the given path as PID file.
+.TP
+.B \-\-preload
+Preload the application. This loads all the application code prior to forking.
+Preloading reduces total memory usage of an application and is only available
+in cluster mode.
+.TP
+.B \-\-prune\-bundler
+Prune out the bundler env if possible.
+.TP
+.B \-q, \-\-quiet
+Do not log requests internally. Default: \fItrue\fR.
+.TP
+.B \-v, \-\-log-requests
+Log requests as they occur.
+.TP
+.BI "\-R, \-\-restart\-cmd " CMD
+The \fBpuma\fR command to run during a hot restart. Default: \fIinferred\fR.
+.TP
+.BI "\-S, \-\-state " PATH
+Where to store the state details.
+.TP
+.BI "\-t, \-\-threads " INT
+Min:max threads to use. Puma will automatically scale the number of threads,
+from the minimum until it caps out at the maximum, based on how much traffic
+is present. Default: \fI0:16\fR.
+.TP
+.B \-\-tcp\-mode
+Run the app in raw TCP mode instead of HTTP mode.
+.TP
+.B \-\-early-hints
+Enable early hints support.
+.TP
+.BI "\-w, \-\-workers " COUNT
+Activate cluster mode and define number of worker processes to create. In this
+mode workers are forked from a master process. Each child process still has
+its own thread pool and the \fB\-t\fR setting is per worker.
+.TP
+.BI "\-\-tag " NAME
+Additional text to display in process listing.
+.TP
+.BI "\-\-redirect\-stdout " FILE
+Redirect \fBSTDOUT\fR to a specific file.
+.TP
+.BI "\-\-redirect\-stderr " FILE
+Redirect \fBSTDERR\fR to a specific file.
+.TP
+.B \-\-[no\-]redirect\-append
+Append to redirected files.
+.TP
+.B \-h, \-\-help
+Show help.
+.TP
+.B \-V, \-\-version
+Print the version information.
+
+.SH EXAMPLES
+.PP
+The following examples show how to bind TCP or sockets:
+.PP
+Bind Puma to a socket with the -b (or --bind) flag:
+.RS
+.B puma -b tcp://127.0.0.1:9292
+.RE
+.PP
+To use a UNIX Socket instead of TCP:
+.RS
+.B puma -b unix:///var/run/puma.sock
+.RE
+.PP
+To change the permissions of the UNIX socket, add a umask parameter:
+.RS
+.B puma -b 'unix:///var/run/puma.sock?umask=0111'
+.RE
+.PP
+In need of a bit of security use SSL sockets:
+.RS
+.B puma -b 'ssl://127.0.0.1:9292?key=path_to_key&cert=path_to_cert'
+.RE
+.PP
+The following example show how to Create a control server and use
+.BR pumactl (1)
+to interact with the control server to restart \fBpuma\fR.
+.RS
+.B puma --control-url tcp://127.0.0.1:9293 --control-token foo
+.br
+.B pumactl --control-url 'tcp://127.0.0.1:9293' --control-token foo restart
+.RE
+.PP
+
+.SH "CONFIGURATION FILE"
+.B puma
+will look for a configuration file at \fIconfig/puma.rb\fR. If an environment
+is specified, either via the \fB\-e\fR and \fB\-\-environment\fR flags, or
+through the \fIRACK_ENV\fR or the \fIRAILS_ENV\fR environment variables, it
+looks for configuration at \fIconfig/puma/<environment_name>.rb\fR.
+.PP
+The \fB\-C\fR flag allows one to pass on a custom configuration location. If
+the value specified is a dash (\fI\-\fR) \fBpuma\fR won't look for any
+configuration file:
+.PP
+.RS
+.B puma -C \(dq\-\(dq
+.RE
+
+.SH "SEE ALSO"
+.PP
+There is extensive documentation at <\%https://puma.io/puma/\%> and
+<\%https://github.com/puma/puma\%>.
+
+.SH AUTHOR
+.PP
+This manual page was written by \fBDaniel Leidert\fP
+<\%dleidert@debian\.org\%>, for the Debian GNU/Linux system (but may be used by
+others).
--- /dev/null
+examples/*
--- /dev/null
+# this is one of several sub-directories; no need to rename it
+repeated-path-segment puma usr/share/doc/puma/examples/puma/
--- /dev/null
+debian/puma.1
+debian/pumactl.1
+
--- /dev/null
+.TH PUMA "1" "January 2020" "PUMA 3.12" "User Commands"
+
+.SH NAME
+pumactl \- command line client for puma
+
+.SH USAGE
+.B pumactl [options...] [commands]
+.PP
+.B pumactl [\-h | \-\-help | \-V | \-\-version]
+
+.SH COMMANDS
+.TP
+.B halt
+Halt the server.
+.TP
+.B restart
+Restart the server.
+.TP
+.B phased-restart
+Restart server but phase out old workers while starting new workers one at a
+time.
+.TP
+.B start
+Start the server.
+.TP
+.B stats
+Show stats about the server.
+.TP
+.B status
+Show server status.
+.TP
+.B stop
+Stop server.
+.TP
+.B reload-worker-directory
+Reload the worker directory.
+.TP
+.B gc
+Start garbage collector.
+.TP
+.B gc-stats
+Show information about garbage collector.
+
+.SH OPTIONS
+.PP
+The following options are available:
+.TP
+.BI "\-F, \-\-config\-file " PATH
+Load given path as a config file.
+.TP
+.BI "\-T, \-\-control\-token " TOKEN
+The \fITOKEN\fR to use as authentication for the control server.
+.TP
+.BI "\-C, \-\-control\-url " URL
+The bind \fIURL\fR to use for the control server and app. Use \fIauto\fR to
+use a temp unix server. This requires to use a \fB\-\-control\-token\fR, which
+needs to be given with every request to the control server (\fItoken=foo\fR).
+.TP
+.BI "\-p, \-\-pid " PID
+Define the TCP port to bind to. Use \fB\-b\fR for more advanced options.
+.TP
+.BI "\-P, \-\-pidfile " PATH
+Use the given path as PID file.
+.TP
+.B \-Q, \-\-quiet
+Don't display messages.
+.TP
+.BI "\-S, \-\-state " PATH
+Where the state file is.
+.TP
+.B \-H, \-\-help
+Show help.
+.TP
+.B \-V, \-\-version
+Print the version information.
+
+.SH EXAMPLES
+Create a control server and use
+.BR pumactl (1)
+to interact with the control server to restart \fBpuma\fR.
+.RS
+.B puma --control-url tcp://127.0.0.1:9293 --control-token foo
+.br
+.B pumactl --control-url 'tcp://127.0.0.1:9293' --control-token foo restart
+.RE
+.PP
+
+.SH "SEE ALSO"
+.PP
+.BR puma (1)
+.PP
+There is extensive documentation at <\%https://puma.io/puma/\%> and
+<\%https://github.com/puma/puma\%>.
+
+.SH AUTHOR
+.PP
+This manual page was written by \fBDaniel Leidert\fP
+<\%dleidert@debian\.org\%>, for the Debian GNU/Linux system (but may be used by
+others).
--- /dev/null
+#!/usr/bin/make -f
+
+export GEM2DEB_TEST_RUNNER = --check-dependencies
+export DH_RUBY = --gem-install
+export DH_RUBY_GEM_INSTALL_EXCLUDE = benchmarks/* docs/* win_gem_test/* tools/* bin/puma-wild
+export LC_ALL = C.UTF-8
+
+%:
+ dh $@ --buildsystem=ruby --with ruby
+
+override_dh_installchangelogs:
+ dh_installchangelogs History.md
+
+override_dh_auto_clean:
+ dh_auto_clean
+ rm -f tmp/restart.txt
--- /dev/null
+3.0 (quilt)
--- /dev/null
+# no signed tarballs by upstream
+puma source: debian-watch-does-not-check-gpg-signature
--- /dev/null
+Test-Command: export AUTOPKGTEST_TEST_PUMA_SERVER_SSL=1 && gem2deb-test-runner --check-dependencies --autopkgtest
+Depends: @, @builddeps@
+Restrictions: allow-stderr
+Features: test-name=ssl
--- /dev/null
+---
+Archive: GitHub
+Bug-Database: https://github.com/puma/puma/issues
+Bug-Submit: https://github.com/puma/puma/issues
+Changelog: https://github.com/puma/puma/tags
+Repository: https://github.com/puma/puma.git
+Repository-Browse: https://github.com/puma/puma
--- /dev/null
+version=4
+opts="filenamemangle=s%(?:.*?)?v?(\d[\d.]*)\.tar\.gz%@PACKAGE@-$1.tar.gz%" \
+ https://github.com/puma/puma/releases .*/v([\d.]+)\.tar\.gz
projects / puma.git / commitdiff