91 lines
3.2 KiB
RPMSpec
91 lines
3.2 KiB
RPMSpec
#
|
|
# spec file for package perl-Server-Starter
|
|
#
|
|
# Copyright (c) 2024 SUSE LLC
|
|
#
|
|
# All modifications and additions to the file contributed by third parties
|
|
# remain the property of their copyright owners, unless otherwise agreed
|
|
# upon. The license for this file, and modifications and additions to the
|
|
# file, is the same license as for the pristine package itself (unless the
|
|
# license for the pristine package is not an Open Source License, in which
|
|
# case the license is the MIT License). An "Open Source License" is a
|
|
# license that conforms to the Open Source Definition (Version 1.9)
|
|
# published by the Open Source Initiative.
|
|
|
|
# Please submit bugfixes or comments via https://bugs.opensuse.org/
|
|
#
|
|
|
|
|
|
%define cpan_name Server-Starter
|
|
Name: perl-Server-Starter
|
|
Version: 0.350.0
|
|
Release: 0
|
|
# 0.35 -> normalize -> 0.350.0
|
|
%define cpan_version 0.35
|
|
License: Artistic-1.0 OR GPL-1.0-or-later
|
|
Summary: Superdaemon for hot-deploying server programs
|
|
URL: https://metacpan.org/release/%{cpan_name}
|
|
Source0: https://cpan.metacpan.org/authors/id/K/KA/KAZUHO/%{cpan_name}-%{cpan_version}.tar.gz
|
|
Source1: cpanspec.yml
|
|
Source100: README.md
|
|
BuildArch: noarch
|
|
BuildRequires: perl
|
|
BuildRequires: perl-macros
|
|
BuildRequires: perl(IO::Socket::IP)
|
|
BuildRequires: perl(Module::Build) >= 0.4005
|
|
BuildRequires: perl(Net::EmptyPort)
|
|
BuildRequires: perl(Test::Requires)
|
|
BuildRequires: perl(Test::SharedFork)
|
|
BuildRequires: perl(Test::TCP) >= 2.08
|
|
Provides: perl(Server::Starter) = %{version}
|
|
Provides: perl(Server::Starter::Guard)
|
|
%undefine __perllib_provides
|
|
%{perl_requires}
|
|
|
|
%description
|
|
It is often a pain to write a server program that supports graceful
|
|
restarts, with no resource leaks. Server::Starter solves the problem by
|
|
splitting the task into two. One is start_server, a script provided as a
|
|
part of the module, which works as a superdaemon that binds to zero or more
|
|
TCP ports or unix sockets, and repeatedly spawns the server program that
|
|
actually handles the necessary tasks (for example, responding to incoming
|
|
connections). The spawned server programs under Server::Starter call
|
|
accept(2) and handle the requests.
|
|
|
|
To gracefully restart the server program, send SIGHUP to the superdaemon.
|
|
The superdaemon spawns a new server program, and if (and only if) it starts
|
|
up successfully, sends SIGTERM to the old server program.
|
|
|
|
By using Server::Starter it is much easier to write a hot-deployable
|
|
server. Following are the only requirements a server program to be run
|
|
under Server::Starter should conform to:
|
|
|
|
* * receive file descriptors to listen to through an environment variable
|
|
|
|
* * perform a graceful shutdown when receiving SIGTERM
|
|
|
|
A Net::Server personality that can be run under Server::Starter exists
|
|
under the name Net::Server::SS::PreFork.
|
|
|
|
%prep
|
|
%autosetup -n %{cpan_name}-%{cpan_version}
|
|
|
|
find . -type f ! -path "*/t/*" ! -name "*.pl" ! -path "*/bin/*" ! -path "*/script/*" ! -path "*/scripts/*" ! -name "configure" -print0 | xargs -0 chmod 644
|
|
|
|
%build
|
|
perl Build.PL --installdirs=vendor
|
|
./Build build --flags=%{?_smp_mflags}
|
|
|
|
%check
|
|
./Build test
|
|
|
|
%install
|
|
./Build install --destdir=%{buildroot} --create_packlist=0
|
|
%perl_gen_filelist
|
|
|
|
%files -f %{name}.files
|
|
%doc Changes README.md
|
|
%license LICENSE
|
|
|
|
%changelog
|