forked from AFPy/python-docs-fr
857 lines
28 KiB
Plaintext
857 lines
28 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2016, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2018-03-23 09:03+0100\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"Language: fr\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/ipaddress.rst:2
|
|
msgid ":mod:`ipaddress` --- IPv4/IPv6 manipulation library"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:9
|
|
msgid "**Source code:** :source:`Lib/ipaddress.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:13
|
|
msgid ""
|
|
":mod:`ipaddress` provides the capabilities to create, manipulate and operate "
|
|
"on IPv4 and IPv6 addresses and networks."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:16
|
|
msgid ""
|
|
"The functions and classes in this module make it straightforward to handle "
|
|
"various tasks related to IP addresses, including checking whether or not two "
|
|
"hosts are on the same subnet, iterating over all hosts in a particular "
|
|
"subnet, checking whether or not a string represents a valid IP address or "
|
|
"network definition, and so on."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:22
|
|
msgid ""
|
|
"This is the full module API reference—for an overview and introduction, see :"
|
|
"ref:`ipaddress-howto`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:33
|
|
msgid "Convenience factory functions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:35
|
|
msgid ""
|
|
"The :mod:`ipaddress` module provides factory functions to conveniently "
|
|
"create IP addresses, networks and interfaces:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:40
|
|
msgid ""
|
|
"Return an :class:`IPv4Address` or :class:`IPv6Address` object depending on "
|
|
"the IP address passed as argument. Either IPv4 or IPv6 addresses may be "
|
|
"supplied; integers less than 2**32 will be considered to be IPv4 by default. "
|
|
"A :exc:`ValueError` is raised if *address* does not represent a valid IPv4 "
|
|
"or IPv6 address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:54
|
|
msgid ""
|
|
"Return an :class:`IPv4Network` or :class:`IPv6Network` object depending on "
|
|
"the IP address passed as argument. *address* is a string or integer "
|
|
"representing the IP network. Either IPv4 or IPv6 networks may be supplied; "
|
|
"integers less than 2**32 will be considered to be IPv4 by default. *strict* "
|
|
"is passed to :class:`IPv4Network` or :class:`IPv6Network` constructor. A :"
|
|
"exc:`ValueError` is raised if *address* does not represent a valid IPv4 or "
|
|
"IPv6 address, or if the network has host bits set."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:68
|
|
msgid ""
|
|
"Return an :class:`IPv4Interface` or :class:`IPv6Interface` object depending "
|
|
"on the IP address passed as argument. *address* is a string or integer "
|
|
"representing the IP address. Either IPv4 or IPv6 addresses may be supplied; "
|
|
"integers less than 2**32 will be considered to be IPv4 by default. A :exc:"
|
|
"`ValueError` is raised if *address* does not represent a valid IPv4 or IPv6 "
|
|
"address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:75
|
|
msgid ""
|
|
"One downside of these convenience functions is that the need to handle both "
|
|
"IPv4 and IPv6 formats means that error messages provide minimal information "
|
|
"on the precise error, as the functions don't know whether the IPv4 or IPv6 "
|
|
"format was intended. More detailed error reporting can be obtained by "
|
|
"calling the appropriate version specific class constructors directly."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:84
|
|
msgid "IP Addresses"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:87
|
|
msgid "Address objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:89
|
|
msgid ""
|
|
"The :class:`IPv4Address` and :class:`IPv6Address` objects share a lot of "
|
|
"common attributes. Some attributes that are only meaningful for IPv6 "
|
|
"addresses are also implemented by :class:`IPv4Address` objects, in order to "
|
|
"make it easier to write code that handles both IP versions correctly. "
|
|
"Address objects are :term:`hashable`, so they can be used as keys in "
|
|
"dictionaries."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:97
|
|
msgid ""
|
|
"Construct an IPv4 address. An :exc:`AddressValueError` is raised if "
|
|
"*address* is not a valid IPv4 address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:100
|
|
msgid "The following constitutes a valid IPv4 address:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:102
|
|
msgid ""
|
|
"A string in decimal-dot notation, consisting of four decimal integers in the "
|
|
"inclusive range 0--255, separated by dots (e.g. ``192.168.0.1``). Each "
|
|
"integer represents an octet (byte) in the address. Leading zeroes are "
|
|
"tolerated only for values less than 8 (as there is no ambiguity between the "
|
|
"decimal and octal interpretations of such strings)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:107
|
|
msgid "An integer that fits into 32 bits."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:108
|
|
msgid ""
|
|
"An integer packed into a :class:`bytes` object of length 4 (most significant "
|
|
"octet first)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:120
|
|
msgid "The appropriate version number: ``4`` for IPv4, ``6`` for IPv6."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:124
|
|
msgid ""
|
|
"The total number of bits in the address representation for this version: "
|
|
"``32`` for IPv4, ``128`` for IPv6."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:127
|
|
msgid ""
|
|
"The prefix defines the number of leading bits in an address that are "
|
|
"compared to determine whether or not an address is part of a network."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:134
|
|
msgid ""
|
|
"The string representation in dotted decimal notation. Leading zeroes are "
|
|
"never included in the representation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:137
|
|
msgid ""
|
|
"As IPv4 does not define a shorthand notation for addresses with octets set "
|
|
"to zero, these two attributes are always the same as ``str(addr)`` for IPv4 "
|
|
"addresses. Exposing these attributes makes it easier to write display code "
|
|
"that can handle both IPv4 and IPv6 addresses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:144
|
|
msgid ""
|
|
"The binary representation of this address - a :class:`bytes` object of the "
|
|
"appropriate length (most significant octet first). This is 4 bytes for IPv4 "
|
|
"and 16 bytes for IPv6."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:150
|
|
msgid "The name of the reverse DNS PTR record for the IP address, e.g.::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:157
|
|
msgid ""
|
|
"This is the name that could be used for performing a PTR lookup, not the "
|
|
"resolved hostname itself."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:164
|
|
msgid ""
|
|
"``True`` if the address is reserved for multicast use. See :RFC:`3171` (for "
|
|
"IPv4) or :RFC:`2373` (for IPv6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:169
|
|
msgid ""
|
|
"``True`` if the address is allocated for private networks. See iana-ipv4-"
|
|
"special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:175
|
|
msgid ""
|
|
"``True`` if the address is allocated for public networks. See iana-ipv4-"
|
|
"special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:183
|
|
msgid ""
|
|
"``True`` if the address is unspecified. See :RFC:`5735` (for IPv4) or :RFC:"
|
|
"`2373` (for IPv6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:188
|
|
msgid "``True`` if the address is otherwise IETF reserved."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:192
|
|
msgid ""
|
|
"``True`` if this is a loopback address. See :RFC:`3330` (for IPv4) or :RFC:"
|
|
"`2373` (for IPv6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:197
|
|
msgid ""
|
|
"``True`` if the address is reserved for link-local usage. See :RFC:`3927`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:206
|
|
msgid ""
|
|
"Construct an IPv6 address. An :exc:`AddressValueError` is raised if "
|
|
"*address* is not a valid IPv6 address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:209
|
|
msgid "The following constitutes a valid IPv6 address:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:211
|
|
msgid ""
|
|
"A string consisting of eight groups of four hexadecimal digits, each group "
|
|
"representing 16 bits. The groups are separated by colons. This describes an "
|
|
"*exploded* (longhand) notation. The string can also be *compressed* "
|
|
"(shorthand notation) by various means. See :RFC:`4291` for details. For "
|
|
"example, ``\"0000:0000:0000:0000:0000:0abc:0007:0def\"`` can be compressed "
|
|
"to ``\"::abc:7:def\"``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:218
|
|
msgid "An integer that fits into 128 bits."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:219
|
|
msgid ""
|
|
"An integer packed into a :class:`bytes` object of length 16, big-endian."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:226
|
|
msgid ""
|
|
"The short form of the address representation, with leading zeroes in groups "
|
|
"omitted and the longest sequence of groups consisting entirely of zeroes "
|
|
"collapsed to a single empty group."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:230
|
|
msgid "This is also the value returned by ``str(addr)`` for IPv6 addresses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:234
|
|
msgid ""
|
|
"The long form of the address representation, with all leading zeroes and "
|
|
"groups consisting entirely of zeroes included."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:238
|
|
msgid ""
|
|
"For the following attributes, see the corresponding documentation of the :"
|
|
"class:`IPv4Address` class:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:253
|
|
msgid "is_global"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:258
|
|
msgid ""
|
|
"``True`` if the address is reserved for site-local usage. Note that the "
|
|
"site-local address space has been deprecated by :RFC:`3879`. Use :attr:"
|
|
"`~IPv4Address.is_private` to test if this address is in the space of unique "
|
|
"local addresses as defined by :RFC:`4193`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:265
|
|
msgid ""
|
|
"For addresses that appear to be IPv4 mapped addresses (starting with ``::"
|
|
"FFFF/96``), this property will report the embedded IPv4 address. For any "
|
|
"other address, this property will be ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:271
|
|
msgid ""
|
|
"For addresses that appear to be 6to4 addresses (starting with "
|
|
"``2002::/16``) as defined by :RFC:`3056`, this property will report the "
|
|
"embedded IPv4 address. For any other address, this property will be "
|
|
"``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:278
|
|
msgid ""
|
|
"For addresses that appear to be Teredo addresses (starting with "
|
|
"``2001::/32``) as defined by :RFC:`4380`, this property will report the "
|
|
"embedded ``(server, client)`` IP address pair. For any other address, this "
|
|
"property will be ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:285
|
|
msgid "Conversion to Strings and Integers"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:287
|
|
msgid ""
|
|
"To interoperate with networking interfaces such as the socket module, "
|
|
"addresses must be converted to strings or integers. This is handled using "
|
|
"the :func:`str` and :func:`int` builtin functions::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:302 ../Doc/library/ipaddress.rst:649
|
|
#: ../Doc/library/ipaddress.rst:785
|
|
msgid "Operators"
|
|
msgstr "Opérateurs"
|
|
|
|
#: ../Doc/library/ipaddress.rst:304
|
|
msgid ""
|
|
"Address objects support some operators. Unless stated otherwise, operators "
|
|
"can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 "
|
|
"with IPv6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:310
|
|
msgid "Comparison operators"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:312
|
|
msgid ""
|
|
"Address objects can be compared with the usual set of comparison operators. "
|
|
"Some examples::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:324
|
|
msgid "Arithmetic operators"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:326
|
|
msgid ""
|
|
"Integers can be added to or subtracted from address objects. Some examples::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:339
|
|
msgid "IP Network definitions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:341
|
|
msgid ""
|
|
"The :class:`IPv4Network` and :class:`IPv6Network` objects provide a "
|
|
"mechanism for defining and inspecting IP network definitions. A network "
|
|
"definition consists of a *mask* and a *network address*, and as such defines "
|
|
"a range of IP addresses that equal the network address when masked (binary "
|
|
"AND) with the mask. For example, a network definition with the mask "
|
|
"``255.255.255.0`` and the network address ``192.168.1.0`` consists of IP "
|
|
"addresses in the inclusive range ``192.168.1.0`` to ``192.168.1.255``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:351
|
|
msgid "Prefix, net mask and host mask"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:353
|
|
msgid ""
|
|
"There are several equivalent ways to specify IP network masks. A *prefix* "
|
|
"``/<nbits>`` is a notation that denotes how many high-order bits are set in "
|
|
"the network mask. A *net mask* is an IP address with some number of high-"
|
|
"order bits set. Thus the prefix ``/24`` is equivalent to the net mask "
|
|
"``255.255.255.0`` in IPv4, or ``ffff:ff00::`` in IPv6. In addition, a *host "
|
|
"mask* is the logical inverse of a *net mask*, and is sometimes used (for "
|
|
"example in Cisco access control lists) to denote a network mask. The host "
|
|
"mask equivalent to ``/24`` in IPv4 is ``0.0.0.255``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:364
|
|
msgid "Network objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:366
|
|
msgid ""
|
|
"All attributes implemented by address objects are implemented by network "
|
|
"objects as well. In addition, network objects implement additional "
|
|
"attributes. All of these are common between :class:`IPv4Network` and :class:"
|
|
"`IPv6Network`, so to avoid duplication they are only documented for :class:"
|
|
"`IPv4Network`. Network objects are :term:`hashable`, so they can be used as "
|
|
"keys in dictionaries."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:375
|
|
msgid ""
|
|
"Construct an IPv4 network definition. *address* can be one of the following:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:377
|
|
msgid ""
|
|
"A string consisting of an IP address and an optional mask, separated by a "
|
|
"slash (``/``). The IP address is the network address, and the mask can be "
|
|
"either a single number, which means it's a *prefix*, or a string "
|
|
"representation of an IPv4 address. If it's the latter, the mask is "
|
|
"interpreted as a *net mask* if it starts with a non-zero field, or as a "
|
|
"*host mask* if it starts with a zero field, with the single exception of an "
|
|
"all-zero mask which is treated as a *net mask*. If no mask is provided, "
|
|
"it's considered to be ``/32``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:386
|
|
msgid ""
|
|
"For example, the following *address* specifications are equivalent: "
|
|
"``192.168.1.0/24``, ``192.168.1.0/255.255.255.0`` and "
|
|
"``192.168.1.0/0.0.0.255``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:390
|
|
msgid ""
|
|
"An integer that fits into 32 bits. This is equivalent to a single-address "
|
|
"network, with the network address being *address* and the mask being ``/32``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:394
|
|
msgid ""
|
|
"An integer packed into a :class:`bytes` object of length 4, big-endian. The "
|
|
"interpretation is similar to an integer *address*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:397
|
|
msgid ""
|
|
"A two-tuple of an address description and a netmask, where the address "
|
|
"description is either a string, a 32-bits integer, a 4-bytes packed integer, "
|
|
"or an existing IPv4Address object; and the netmask is either an integer "
|
|
"representing the prefix length (e.g. ``24``) or a string representing the "
|
|
"prefix mask (e.g. ``255.255.255.0``)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:403
|
|
msgid ""
|
|
"An :exc:`AddressValueError` is raised if *address* is not a valid IPv4 "
|
|
"address. A :exc:`NetmaskValueError` is raised if the mask is not valid for "
|
|
"an IPv4 address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:407 ../Doc/library/ipaddress.rst:599
|
|
msgid ""
|
|
"If *strict* is ``True`` and host bits are set in the supplied address, then :"
|
|
"exc:`ValueError` is raised. Otherwise, the host bits are masked out to "
|
|
"determine the appropriate network address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:411
|
|
msgid ""
|
|
"Unless stated otherwise, all network methods accepting other network/address "
|
|
"objects will raise :exc:`TypeError` if the argument's IP version is "
|
|
"incompatible to ``self``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:417 ../Doc/library/ipaddress.rst:605
|
|
msgid "Added the two-tuple form for the *address* constructor parameter."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:422
|
|
msgid ""
|
|
"Refer to the corresponding attribute documentation in :class:`IPv4Address`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:432
|
|
msgid ""
|
|
"These attributes are true for the network as a whole if they are true for "
|
|
"both the network address and the broadcast address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:437
|
|
msgid ""
|
|
"The network address for the network. The network address and the prefix "
|
|
"length together uniquely define a network."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:442
|
|
msgid ""
|
|
"The broadcast address for the network. Packets sent to the broadcast address "
|
|
"should be received by every host on the network."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:447
|
|
msgid "The host mask, as an :class:`IPv4Address` object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:451
|
|
msgid "The net mask, as an :class:`IPv4Address` object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:457
|
|
msgid ""
|
|
"A string representation of the network, with the mask in prefix notation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:460
|
|
msgid ""
|
|
"``with_prefixlen`` and ``compressed`` are always the same as "
|
|
"``str(network)``. ``exploded`` uses the exploded form the network address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:466
|
|
msgid ""
|
|
"A string representation of the network, with the mask in net mask notation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:471
|
|
msgid ""
|
|
"A string representation of the network, with the mask in host mask notation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:476
|
|
msgid "The total number of addresses in the network."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:480
|
|
msgid "Length of the network prefix, in bits."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:484
|
|
msgid ""
|
|
"Returns an iterator over the usable hosts in the network. The usable hosts "
|
|
"are all the IP addresses that belong to the network, except the network "
|
|
"address itself and the network broadcast address. For networks with a mask "
|
|
"length of 31, the network address and network broadcast address are also "
|
|
"included in the result."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:499
|
|
msgid ""
|
|
"``True`` if this network is partly or wholly contained in *other* or *other* "
|
|
"is wholly contained in this network."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:504
|
|
msgid ""
|
|
"Computes the network definitions resulting from removing the given *network* "
|
|
"from this one. Returns an iterator of network objects. Raises :exc:"
|
|
"`ValueError` if *network* is not completely contained in this network."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:517
|
|
msgid ""
|
|
"The subnets that join to make the current network definition, depending on "
|
|
"the argument values. *prefixlen_diff* is the amount our prefix length "
|
|
"should be increased by. *new_prefix* is the desired new prefix of the "
|
|
"subnets; it must be larger than our prefix. One and only one of "
|
|
"*prefixlen_diff* and *new_prefix* must be set. Returns an iterator of "
|
|
"network objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:542
|
|
msgid ""
|
|
"The supernet containing this network definition, depending on the argument "
|
|
"values. *prefixlen_diff* is the amount our prefix length should be "
|
|
"decreased by. *new_prefix* is the desired new prefix of the supernet; it "
|
|
"must be smaller than our prefix. One and only one of *prefixlen_diff* and "
|
|
"*new_prefix* must be set. Returns a single network object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:558
|
|
msgid ""
|
|
"Compare this network to *other*. In this comparison only the network "
|
|
"addresses are considered; host bits aren't. Returns either ``-1``, ``0`` or "
|
|
"``1``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:572
|
|
msgid ""
|
|
"Construct an IPv6 network definition. *address* can be one of the following:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:574
|
|
msgid ""
|
|
"A string consisting of an IP address and an optional prefix length, "
|
|
"separated by a slash (``/``). The IP address is the network address, and "
|
|
"the prefix length must be a single number, the *prefix*. If no prefix "
|
|
"length is provided, it's considered to be ``/128``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:579
|
|
msgid ""
|
|
"Note that currently expanded netmasks are not supported. That means ``2001:"
|
|
"db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` not."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:583
|
|
msgid ""
|
|
"An integer that fits into 128 bits. This is equivalent to a single-address "
|
|
"network, with the network address being *address* and the mask being "
|
|
"``/128``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:587
|
|
msgid ""
|
|
"An integer packed into a :class:`bytes` object of length 16, big-endian. The "
|
|
"interpretation is similar to an integer *address*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:590
|
|
msgid ""
|
|
"A two-tuple of an address description and a netmask, where the address "
|
|
"description is either a string, a 128-bits integer, a 16-bytes packed "
|
|
"integer, or an existing IPv6Address object; and the netmask is an integer "
|
|
"representing the prefix length."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:595
|
|
msgid ""
|
|
"An :exc:`AddressValueError` is raised if *address* is not a valid IPv6 "
|
|
"address. A :exc:`NetmaskValueError` is raised if the mask is not valid for "
|
|
"an IPv6 address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:628
|
|
msgid ""
|
|
"Returns an iterator over the usable hosts in the network. The usable hosts "
|
|
"are all the IP addresses that belong to the network, except the Subnet-"
|
|
"Router anycast address. For networks with a mask length of 127, the Subnet-"
|
|
"Router anycast address is also included in the result."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:639
|
|
msgid ""
|
|
"Refer to the corresponding attribute documentation in :class:`IPv4Network`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:644
|
|
msgid ""
|
|
"These attribute is true for the network as a whole if it is true for both "
|
|
"the network address and the broadcast address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:651
|
|
msgid ""
|
|
"Network objects support some operators. Unless stated otherwise, operators "
|
|
"can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 "
|
|
"with IPv6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:657 ../Doc/library/ipaddress.rst:793
|
|
msgid "Logical operators"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:659
|
|
msgid ""
|
|
"Network objects can be compared with the usual set of logical operators. "
|
|
"Network objects are ordered first by network address, then by net mask."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:664
|
|
msgid "Iteration"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:666
|
|
msgid ""
|
|
"Network objects can be iterated to list all the addresses belonging to the "
|
|
"network. For iteration, *all* hosts are returned, including unusable hosts "
|
|
"(for usable hosts, use the :meth:`~IPv4Network.hosts` method). An example::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:693
|
|
msgid "Networks as containers of addresses"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:695
|
|
msgid "Network objects can act as containers of addresses. Some examples::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:708
|
|
msgid "Interface objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:710
|
|
msgid ""
|
|
"Interface objects are :term:`hashable`, so they can be used as keys in "
|
|
"dictionaries."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:715
|
|
msgid ""
|
|
"Construct an IPv4 interface. The meaning of *address* is as in the "
|
|
"constructor of :class:`IPv4Network`, except that arbitrary host addresses "
|
|
"are always accepted."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:719
|
|
msgid ""
|
|
":class:`IPv4Interface` is a subclass of :class:`IPv4Address`, so it inherits "
|
|
"all the attributes from that class. In addition, the following attributes "
|
|
"are available:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:725
|
|
msgid "The address (:class:`IPv4Address`) without network information."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:733
|
|
msgid "The network (:class:`IPv4Network`) this interface belongs to."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:741
|
|
msgid ""
|
|
"A string representation of the interface with the mask in prefix notation."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:749
|
|
msgid ""
|
|
"A string representation of the interface with the network as a net mask."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:757
|
|
msgid ""
|
|
"A string representation of the interface with the network as a host mask."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:766
|
|
msgid ""
|
|
"Construct an IPv6 interface. The meaning of *address* is as in the "
|
|
"constructor of :class:`IPv6Network`, except that arbitrary host addresses "
|
|
"are always accepted."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:770
|
|
msgid ""
|
|
":class:`IPv6Interface` is a subclass of :class:`IPv6Address`, so it inherits "
|
|
"all the attributes from that class. In addition, the following attributes "
|
|
"are available:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:780
|
|
msgid ""
|
|
"Refer to the corresponding attribute documentation in :class:`IPv4Interface`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:787
|
|
msgid ""
|
|
"Interface objects support some operators. Unless stated otherwise, "
|
|
"operators can only be applied between compatible objects (i.e. IPv4 with "
|
|
"IPv4, IPv6 with IPv6)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:795
|
|
msgid ""
|
|
"Interface objects can be compared with the usual set of logical operators."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:797
|
|
msgid ""
|
|
"For equality comparison (``==`` and ``!=``), both the IP address and network "
|
|
"must be the same for the objects to be equal. An interface will not compare "
|
|
"equal to any address or network object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:801
|
|
msgid ""
|
|
"For ordering (``<``, ``>``, etc) the rules are different. Interface and "
|
|
"address objects with the same IP version can be compared, and the address "
|
|
"objects will always sort before the interface objects. Two interface "
|
|
"objects are first compared by their networks and, if those are the same, "
|
|
"then by their IP addresses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:809
|
|
msgid "Other Module Level Functions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:811
|
|
msgid "The module also provides the following module level functions:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:815
|
|
msgid ""
|
|
"Represent an address as 4 packed bytes in network (big-endian) order. "
|
|
"*address* is an integer representation of an IPv4 IP address. A :exc:"
|
|
"`ValueError` is raised if the integer is negative or too large to be an IPv4 "
|
|
"IP address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:828
|
|
msgid ""
|
|
"Represent an address as 16 packed bytes in network (big-endian) order. "
|
|
"*address* is an integer representation of an IPv6 IP address. A :exc:"
|
|
"`ValueError` is raised if the integer is negative or too large to be an IPv6 "
|
|
"IP address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:836
|
|
msgid ""
|
|
"Return an iterator of the summarized network range given the first and last "
|
|
"IP addresses. *first* is the first :class:`IPv4Address` or :class:"
|
|
"`IPv6Address` in the range and *last* is the last :class:`IPv4Address` or :"
|
|
"class:`IPv6Address` in the range. A :exc:`TypeError` is raised if *first* "
|
|
"or *last* are not IP addresses or are not of the same version. A :exc:"
|
|
"`ValueError` is raised if *last* is not greater than *first* or if *first* "
|
|
"address version is not 4 or 6."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:852
|
|
msgid ""
|
|
"Return an iterator of the collapsed :class:`IPv4Network` or :class:"
|
|
"`IPv6Network` objects. *addresses* is an iterator of :class:`IPv4Network` "
|
|
"or :class:`IPv6Network` objects. A :exc:`TypeError` is raised if "
|
|
"*addresses* contains mixed version objects."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:865
|
|
msgid ""
|
|
"Return a key suitable for sorting between networks and addresses. Address "
|
|
"and Network objects are not sortable by default; they're fundamentally "
|
|
"different, so the expression::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:871
|
|
msgid ""
|
|
"doesn't make sense. There are some times however, where you may wish to "
|
|
"have :mod:`ipaddress` sort these anyway. If you need to do this, you can "
|
|
"use this function as the *key* argument to :func:`sorted()`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:875
|
|
msgid "*obj* is either a network or address object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:879
|
|
msgid "Custom Exceptions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:881
|
|
msgid ""
|
|
"To support more specific error reporting from class constructors, the module "
|
|
"defines the following exceptions:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:886
|
|
msgid "Any value error related to the address."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/ipaddress.rst:891
|
|
msgid "Any value error related to the net mask."
|
|
msgstr ""
|