1PORTRESERVE(1)           TCP port reservation utility           PORTRESERVE(1)
2
3
4

NAME

6       portreserve - reserve ports to prevent portmap mapping them
7

SYNOPSIS

9       portreserve
10

DESCRIPTION

12       The portreserve program aims to help services with well-known ports
13       that lie in the bindresvport range. It prevents portmap (or other
14       programs using bindresvport) from occupying a real service´s port by
15       occupying it itself, until the real service tells it to release the
16       port (generally in its init script).
17
18       It is intended that portreserve runs from an initscript of its own, and
19       services wishing to interact with it should use portrelease.
20
21       When the portreserve daemon is started, it examines the
22       /etc/portreserve/ directory. Each file not containing “.”  or “~” in
23       its name is considered to be a service configuration file, and must
24       contain a service name (as listed in /etc/services) or a port number.
25       UDP services may be specified by appending "/udp" to the service name,
26       and TCP services by "/tcp". Several services may be specified, one per
27       line.
28
29       For example, /etc/portreserve/cups might contain the string “ipp” or,
30       equivalently, “ipp/tcp” and “ipp/udp” on separate lines.
31
32       For each service configuration file, a socket is created and bound to
33       the appropriate port. A service wishing to bind to its port must first
34       run portrelease, which instructs portreserve to release the port
35       associated with the service.
36
37       If more than one service configuration file refers to the same port,
38       that port is released whenever the first of the overlapping services is
39       released.
40
41       Once all the reserved ports have been released, the daemon exits.
42

FILES

44       /etc/portreserve/*
45           Service configuration files
46
47       /var/run/portreserve/socket
48           communication socket for portrelease
49

SEE ALSO

51       portrelease(1)
52

AUTHOR

54       Tim Waugh <twaugh@redhat.com>
55           Author.
56
57
58
59portreserve                     12 January 2016                 PORTRESERVE(1)