summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man5/services.5
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-17 10:52:33 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-17 10:52:33 +0000
commit2c3307fb903f427be3d021c5780b75cac9af2ce8 (patch)
tree65cf431f40b7481d81ae2dfce9576342686448f7 /upstream/opensuse-tumbleweed/man5/services.5
parentReleasing progress-linux version 4.22.0-1~progress7.99u1. (diff)
downloadmanpages-l10n-2c3307fb903f427be3d021c5780b75cac9af2ce8.tar.xz
manpages-l10n-2c3307fb903f427be3d021c5780b75cac9af2ce8.zip
Merging upstream version 4.23.0.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/opensuse-tumbleweed/man5/services.5')
-rw-r--r--upstream/opensuse-tumbleweed/man5/services.528
1 files changed, 14 insertions, 14 deletions
diff --git a/upstream/opensuse-tumbleweed/man5/services.5 b/upstream/opensuse-tumbleweed/man5/services.5
index 5003f615..0d8f6c88 100644
--- a/upstream/opensuse-tumbleweed/man5/services.5
+++ b/upstream/opensuse-tumbleweed/man5/services.5
@@ -11,7 +11,7 @@
.\" Thu Jan 11 12:14:41 1996 Austin Donnelly <and1000@cam.ac.uk>
.\" * Merged two services(5) manpages
.\"
-.TH services 5 2022-10-30 "Linux man-pages 6.05.01"
+.TH services 5 2024-05-02 "Linux man-pages (unreleased)"
.SH NAME
services \- Internet network services list
.SH DESCRIPTION
@@ -29,13 +29,13 @@ The C library routines
and
.BR endservent (3)
support querying this file from programs.
-.PP
+.P
Port numbers are assigned by the IANA (Internet Assigned Numbers
Authority), and their current policy is to assign both TCP and UDP
protocols when assigning a port number.
Therefore, most entries will
have two entries, even for TCP-only services.
-.PP
+.P
Port numbers below 1024 (so-called "low numbered" ports) can be
bound to only by root (see
.BR bind (2),
@@ -47,7 +47,7 @@ that the service running on the port is the standard implementation,
and not a rogue service run by a user of the machine.
Well-known port numbers specified by the IANA are normally
located in this root-only space.
-.PP
+.P
The presence of an entry for a service in the
.B services
file does not necessarily mean that the service is currently running
@@ -62,7 +62,7 @@ and so won't appear in
.BR inetd.conf (5).
In particular, news (NNTP) and mail (SMTP) servers are often
initialized from the system boot scripts.
-.PP
+.P
The location of the
.B services
file is defined by
@@ -71,7 +71,7 @@ in
.IR <netdb.h> "."
This is usually set to
.IR /etc/services "."
-.PP
+.P
Each line describes one service, and is of the form:
.IP
\f2service-name\ \ \ port\f3/\f2protocol\ \ \ \f1[\f2aliases ...\f1]
@@ -103,13 +103,13 @@ is an optional space or tab separated list of other names for this
service.
Again, the names are case
sensitive.
-.PP
+.P
Either spaces or tabs may be used to separate the fields.
-.PP
+.P
Comments are started by the hash sign (#) and continue until the end
of the line.
Blank lines are skipped.
-.PP
+.P
The
.I service-name
should begin in the first column of the file, since leading spaces are
@@ -120,7 +120,7 @@ However, a conservative choice of characters should be used to minimize
compatibility problems.
For example, a\-z, 0\-9, and hyphen (\-) would seem a
sensible choice.
-.PP
+.P
Lines not matching this format should not be present in the
file.
(Currently, they are silently skipped by
@@ -129,7 +129,7 @@ file.
and
.BR getservbyport (3).
However, this behavior should not be relied on.)
-.PP
+.P
.\" The following is not true as at glibc 2.8 (a line with a comma is
.\" ignored by getservent()); it's not clear if/when it was ever true.
.\" As a backward compatibility feature, the slash (/) between the
@@ -142,11 +142,11 @@ However, this behavior should not be relied on.)
.\"
This file might be distributed over a network using a network-wide
naming service like Yellow Pages/NIS or BIND/Hesiod.
-.PP
+.P
A sample
.B services
file might look like this:
-.PP
+.P
.in +4n
.EX
netstat 15/tcp
@@ -195,5 +195,5 @@ Definition of
.BR inetd.conf (5),
.BR protocols (5),
.BR inetd (8)
-.PP
+.P
Assigned Numbers RFC, most recently RFC\ 1700, (AKA STD0002).