NAME

       firewalld.service - firewalld service configuration files

SYNOPSIS

       /etc/firewalld/services/service.xml
       /usr/lib/firewalld/services/service.xml

DESCRIPTION

       A firewalld service configuration file provides the information of a service entry for
       firewalld. The most important configuration options are ports, modules and destination
       addresses.

       This example configuration file shows the structure of a service configuration file:

           <?xml version="1.0" encoding="utf-8"?>
           <service>
             <short>My Service</short>
             <description>description</description>
             <port port="137" protocol="tcp"/>
             <protocol value="igmp"/>
             <module name="nf_conntrack_netbios_ns"/>
             <destination ipv4="224.0.0.251" ipv6="ff02::fb"/>
             <include service="ssdp"/>
             <helper name="ftp"/>
           </service>

OPTIONS

       The config can contain these tags and attributes. Some of them are mandatory, others
       optional.

   service
       The mandatory service start and end tag defines the service. This tag can only be used
       once in a service configuration file. There are optional attributes for services:

       version="string"
           To give the service a version.

   short
       Is an optional start and end tag and is used to give an service a more readable name.

   description
       Is an optional start and end tag to have a description for a service.

   port
       Is an optional empty-element tag and can be used several times to have more than one port
       entry. All attributes of a port entry are mandatory:

       port="string"
           The port string can be a single port number or a port range portid-portid or also
           empty to match a protocol only.

       protocol="string"
           The protocol value can either be tcp, udp, sctp or dccp.

       For compatibility with older firewalld versions, it is possible to add protocols with the
       port option where the port is empty. With the addition of native protocol support in the
       service, this it not needed anymore. These entries will automatically be converted to
       protocols. With the next modification of the service file, the enries will be listed as
       protocols.

   protocol
       Is an optional empty-element tag and can be used several times to have more than one
       protocol entry. A protocol entry has exactly one attribute:

       value="string"
           The protocol can be any protocol supported by the system. Please have a look at
           /etc/protocols for supported protocols.

   source-port
       Is an optional empty-element tag and can be used several times to have more than one
       source port entry. All attributes of a source port entry are mandatory:

       port="string"
           The port string can be a single port number or a port range portid-portid.

       protocol="string"
           The protocol value can either be tcp, udp, sctp or dccp.

   module
       This element is deprecated. Please use helper described below in the section called
       “helper”.

   destination
       Is an optional empty-element tag and can be used only once. The destination specifies the
       destination network as a network IP address (optional with /mask), or a plain IP address.
       The use of hostnames is not recommended, because these will only be resolved at service
       activation and transmitted to the kernel. For more information in this element, please
       have a look at --destination in iptables(8) and ip6tables(8).

       ipv4="address[/mask]"
           The IPv4 destination address with optional mask.

       ipv6="address[/mask]"
           The IPv6 destination address with optional mask.

   include
       Is an optional empty-element tag and can be used several times to have more than one
       include entry. An include entry has exactly one attribute:

       service="string"
           The include can be any service supported by firewalld.

           Warning:Firewalld will only check that the included service is a valid service if it's
           applied to a zone.

   helper
       Is an optional empty-element tag and can be used several times to have more than one
       helper entry. An helper entry has exactly one attribute:

       name="string"
           The helper can be any helper supported by firewalld.

SEE ALSO

       firewall-applet(1), firewalld(1), firewall-cmd(1), firewall-config(1), firewalld.conf(5),
       firewalld.direct(5), firewalld.dbus(5), firewalld.icmptype(5), firewalld.lockdown-
       whitelist(5), firewall-offline-cmd(1), firewalld.richlanguage(5), firewalld.service(5),
       firewalld.zone(5), firewalld.zones(5), firewalld.policy(5), firewalld.policies(5),
       firewalld.ipset(5), firewalld.helper(5)

NOTES

       firewalld home page:
           http://firewalld.org

       More documentation with examples:
           http://fedoraproject.org/wiki/FirewallD

AUTHORS

       Thomas Woerner <twoerner@redhat.com>
           Developer

       Jiri Popelka <jpopelka@redhat.com>
           Developer

       Eric Garver <eric@garver.life>
           Developer