X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=docs%2Fconf%2Flinks.conf.example;h=19d770d3530a3368fb64f7db3fd681657f6b9003;hb=e0dc7691c4cff3a38bc12adf10b3709d8c4901ba;hp=b196c5621002b76a6daab6371c6a28132e3e8a60;hpb=cc01e2144c2c9a0fd5c71c9a32300906aa14a246;p=user%2Fhenk%2Fcode%2Finspircd.git diff --git a/docs/conf/links.conf.example b/docs/conf/links.conf.example index b196c5621..19d770d35 100644 --- a/docs/conf/links.conf.example +++ b/docs/conf/links.conf.example @@ -1,3 +1,23 @@ +#-#-#-#-#-#-#-#-#-#-#-#- PORT CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#- +# # +# Configure the port and address bindings for linking here. # +# # +# Refer to the port configuration section in inspircd.conf.example # +# for more information about the available options. # +# # + +# TLS (SSL) listener that binds on a TCP/IP endpoint: + + +# Plaintext listener that binds on a TCP/IP endpoint: + + + #-#-#-#-#-#-#-#-#-#-#- SERVER LINK CONFIGURATION -#-#-#-#-#-#-#-#-#-# # # # Defines which servers can link to this one, and which servers this # @@ -10,18 +30,18 @@ # |_| \_\___|\__,_|\__,_| |_| |_| |_|_|___/ |____/|_|\__(_) # # # # If you want to link servers to InspIRCd you must load the # -# m_spanningtree.so module! # -# # +# spanningtree module! If you do not load this module, server ports # +# will NOT work! # # # value of the remote server. - name="hub.penguin.org" + name="hub.example.org" # ipaddr: The IP address of the remote server. # Can also be a hostname, but hostname must resolve. - ipaddr="penguin.box.com" + ipaddr="penguin.example.org" # port: The port to connect to the server on. # It must be bound as a server port on the other server. @@ -29,54 +49,58 @@ # allowmask: Range of IP addresses to allow for this link. # Can be a CIDR (see example). - allowmask="69.58.44.0/24 127.0.0.0/8" + allowmask="203.0.113.0/24 127.0.0.0/8 2001:db8::/32" # timeout: If defined, this option defines how long the server # will wait to consider the connect attempt failed and try the # failover (see above). - timeout="300" + timeout="5m" - # ssl: If defined, this states the SSL module that will be used when - # making an outbound connection to the server. Options are: "openssl" - # and "gnutls" (they are compatible with each other). + # sslprofile: If defined, this states the TLS (SSL) profile that will be used + # when making an outbound connection to the server. See the docs page for + # the TLS (SSL) module you are using for more details: + # + # GnuTLS: https://docs.inspircd.org/3/modules/ssl_gnutls#sslprofile + # mbedTLS: https://docs.inspircd.org/3/modules/ssl_mbedtls#sslprofile + # OpenSSL: https://docs.inspircd.org/3/modules/ssl_openssl#sslprofile # - # You will need to load the m_ssl_openssl.so module for openssl, - # m_ssl_gnutls.so for gnutls. The server port that you connect to - # must be capable of accepting this type of connection. - ssl="gnutls" + # You will need to load the ssl_openssl module for OpenSSL, ssl_gnutls + # for GnuTLS and ssl_mbedtls for mbedTLS. The server port that you + # connect to must be capable of accepting this type of connection. + sslprofile="Servers" # fingerprint: If defined, this option will force servers to be - # authenticated using SSL Fingerprints. See http://wiki.inspircd.org/SSL - # for more information. This will require an SSL link for both inbound - # and outbound connections. + # authenticated using TLS (SSL) certificate fingerprints. See + # https://docs.inspircd.org/3/modules/spanningtree for more information. + # This will require a TLS (SSL) link for both inbound and outbound connections. #fingerprint="" # bind: Local IP address to bind to. bind="1.2.3.4" - # statshidden: defines if IP is shown to opers when - # /stats c is invoked. + # statshidden: Defines if IP is shown to opers when + # /STATS c is invoked. statshidden="no" # hidden: If this is set to yes, this server and its "child" - # servers will not be shown when users do a /map or /links + # servers will not be shown when users do a /MAP or /LINKS. hidden="no" - # passwords: the passwords we send and receive. + # passwords: The passwords we send and receive. # The remote server will have these passwords reversed. # Passwords that contain a space character or begin with # a colon (:) are invalid and may not be used. sendpass="outgoing!password" recvpass="incoming!password"> -# A duplicate of the first link block without comments +# A duplicate of the first link block without comments, # if you like copying & pasting. - -# Simple autoconnect block. This enables automatic connection of a server +# Simple autoconnect block. This enables automatic connections to a server. # Recommended setup is to have leaves connect to the hub, and have no # automatic connections started by the hub. - + # Failover autoconnect block. If you have multiple hubs, or want your network # to automatically link even if the hub is down, you can specify multiple # space separated servers to autoconnect; they will be tried in a round # robin fashion until one succeeds. Period defines the time for restarting # a single loop. - - - -#-#-#-#-#-#-#-#-#-#-#-#- ULINES CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#-# -# This tag defines a ulined server. A U-Lined server has special # -# permissions, and should be used with caution. Services servers are # -# usually u-lined in this manner. # -# # -# The 'silent' value, if set to yes, indicates that this server should# -# not generate quit and connect notices, which can cut down on noise # -# to opers on the network. # -# # - + + + +#-#-#-#-#-#-#-#-#-#-#-#-# U-LINES CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#-# +# This tag defines a U-lined server. A U-lined server has special # +# permissions, and should be used with caution. Services servers are # +# usually U-lined in this manner. # +# # +# The 'silent' value, if set to yes, indicates that this server should # +# not generate quit and connect notices, which can cut down on noise # +# to opers on the network. # +# # + + +# Once you have edited this file you can remove this line. This is just to +# ensure that you don't hastily include the file without reading it. +