/locale/ja/LC_MESSAGES/library/socket.po
Portable Object | 1669 lines | 1470 code | 199 blank | 0 comment | 0 complexity | 12c854caa4679aa02bb96e8c20e36467 MD5 | raw file
- # SOME DESCRIPTIVE TITLE.
- # Copyright (C) 1990-2013, Python Software Foundation
- # This file is distributed under the same license as the Python package.
- #
- # Translators:
- # ryosuke.mondo <ryosuke.mondo@gmail.com>, 2012
- msgid ""
- msgstr ""
- "Project-Id-Version: (Deprecated)Python Document Japanese\n"
- "Report-Msgid-Bugs-To: \n"
- "POT-Creation-Date: 2013-12-30 03:15+0900\n"
- "PO-Revision-Date: 2014-01-07 09:40+0000\n"
- "Last-Translator: Naoki INADA <songofacandy@gmail.com>\n"
- "Language-Team: Japanese (http://www.transifex.com/projects/p/python-doc-ja/language/ja/)\n"
- "MIME-Version: 1.0\n"
- "Content-Type: text/plain; charset=UTF-8\n"
- "Content-Transfer-Encoding: 8bit\n"
- "Language: ja\n"
- "Plural-Forms: nplurals=1; plural=0;\n"
- # 0236b58df588443eb76a12ea95636e8d
- #: ../../library/socket.rst:2
- msgid ":mod:`socket` --- Low-level networking interface"
- msgstr ":mod:`socket` --- 低レベルネットワークインターフェース"
- # 39ac663abd6946c1acad4bb1e2679a2b
- #: ../../library/socket.rst:8
- msgid ""
- "This module provides access to the BSD *socket* interface. It is available "
- "on all modern Unix systems, Windows, MacOS, OS/2, and probably additional "
- "platforms."
- msgstr "このモジュールは、PythonでBSD *ソケット(socket)* インターフェースを利用するために使用します。最近のUnixシステム、Windows, Max OS X, BeOS, OS/2など、多くのプラットフォームで利用可能です。"
- # 718a821c9d5f40348031abc067c5616c
- #: ../../library/socket.rst:14
- msgid ""
- "Some behavior may be platform dependent, since calls are made to the "
- "operating system socket APIs."
- msgstr "いくつかの振る舞いはプラットフォームに依存します。オペレーティングシステムのソケットAPIを呼び出しているためです。"
- # ca7b34c1b7d240388581b066ca7b1a48
- #: ../../library/socket.rst:19
- msgid ""
- "The Python interface is a straightforward transliteration of the Unix system"
- " call and library interface for sockets to Python's object-oriented style: "
- "the :func:`.socket` function returns a :dfn:`socket object` whose methods "
- "implement the various socket system calls. Parameter types are somewhat "
- "higher-level than in the C interface: as with :meth:`read` and :meth:`write`"
- " operations on Python files, buffer allocation on receive operations is "
- "automatic, and buffer length is implicit on send operations."
- msgstr ""
- # e0c20439c0164148aad4d48a4ca7d254
- #: ../../library/socket.rst:31
- msgid "Module :mod:`socketserver`"
- msgstr ""
- # efec016c2eff4baab798422bb99ef14a
- #: ../../library/socket.rst:31
- msgid "Classes that simplify writing network servers."
- msgstr "ネットワークサーバの開発を省力化するためのクラス群。"
- # 989e5cb4de5e4315a9114f887158f0c1
- #: ../../library/socket.rst:33
- msgid "Module :mod:`ssl`"
- msgstr ""
- # 6c189024ffc94750bf12dc9d670119e3
- #: ../../library/socket.rst:34
- msgid "A TLS/SSL wrapper for socket objects."
- msgstr "ソケットオブジェクトに対する TLS/SSL ラッパー."
- # 00a4d609e3e8483da087b231047ed51c
- #: ../../library/socket.rst:38
- msgid "Socket families"
- msgstr "ソケットファミリー"
- # 08f038c8dba14eedb2fcebc97d071090
- #: ../../library/socket.rst:40
- msgid ""
- "Depending on the system and the build options, various socket families are "
- "supported by this module."
- msgstr "どのシステムで実行するかとビルドオプションに依存しますが、このモジュールによって多様なソケットファミリーをサポートします。"
- # 6addf586f996425cb91b8dea853c5e7c
- #: ../../library/socket.rst:43
- msgid ""
- "The address format required by a particular socket object is automatically "
- "selected based on the address family specified when the socket object was "
- "created. Socket addresses are represented as follows:"
- msgstr "特定のソケットオブジェクトによってはアドレスフォーマットが必要とされますがソケットオブジェクトが生成されたときに指定されたアドレスファミリーを元に自動的に選択します。ソケットアドレスについては次の通りです:"
- # 3fa272622cd04224a788ad32e0fc01c6
- #: ../../library/socket.rst:47
- msgid ""
- "The address of an :const:`AF_UNIX` socket bound to a file system node is "
- "represented as a string, using the file system encoding and the "
- "``'surrogateescape'`` error handler (see :pep:`383`). An address in Linux's"
- " abstract namespace is returned as a :class:`bytes` object with an initial "
- "null byte; note that sockets in this namespace can communicate with normal "
- "file system sockets, so programs intended to run on Linux may need to deal "
- "with both types of address. A string or :class:`bytes` object can be used "
- "for either type of address when passing it as an argument."
- msgstr ""
- # 9839710817f94ceaaac5863b76436945
- # 7bd17ebd489b4cfa9d6c02a271ba933e
- #: ../../library/socket.rst:57 ../../library/socket.rst:57
- msgid ""
- "Previously, :const:`AF_UNIX` socket paths were assumed to use UTF-8 "
- "encoding."
- msgstr ""
- # aec6ff2faa6e469cb726b7391dbb22b1
- #: ../../library/socket.rst:61
- msgid ""
- "A pair ``(host, port)`` is used for the :const:`AF_INET` address family, "
- "where *host* is a string representing either a hostname in Internet domain "
- "notation like ``'daring.cwi.nl'`` or an IPv4 address like "
- "``'100.50.200.5'``, and *port* is an integer."
- msgstr ""
- # 8b2cdc7122d04792a16dffe89c0077b8
- #: ../../library/socket.rst:66
- msgid ""
- "For :const:`AF_INET6` address family, a four-tuple ``(host, port, flowinfo, "
- "scopeid)`` is used, where *flowinfo* and *scopeid* represent the "
- "``sin6_flowinfo`` and ``sin6_scope_id`` members in :const:`struct "
- "sockaddr_in6` in C. For :mod:`socket` module methods, *flowinfo* and "
- "*scopeid* can be omitted just for backward compatibility. Note, however, "
- "omission of *scopeid* can cause problems in manipulating scoped IPv6 "
- "addresses."
- msgstr ""
- # 0e2a1a9ff3f94bc184e4dd65ce0a0cf4
- #: ../../library/socket.rst:73
- msgid ""
- ":const:`AF_NETLINK` sockets are represented as pairs ``(pid, groups)``."
- msgstr ""
- # 5d42958d185e4699a2671ea9865f37ed
- #: ../../library/socket.rst:75
- msgid ""
- "Linux-only support for TIPC is available using the :const:`AF_TIPC` address "
- "family. TIPC is an open, non-IP based networked protocol designed for use "
- "in clustered computer environments. Addresses are represented by a tuple, "
- "and the fields depend on the address type. The general tuple form is "
- "``(addr_type, v1, v2, v3 [, scope])``, where:"
- msgstr ""
- # ed9834ecf78143d0bfccee3128289a04
- #: ../../library/socket.rst:81
- msgid ""
- "*addr_type* is one of :const:`TIPC_ADDR_NAMESEQ`, :const:`TIPC_ADDR_NAME`, "
- "or :const:`TIPC_ADDR_ID`."
- msgstr ""
- # 839d171395dd4e5abec7fa7d19f06416
- #: ../../library/socket.rst:83
- msgid ""
- "*scope* is one of :const:`TIPC_ZONE_SCOPE`, :const:`TIPC_CLUSTER_SCOPE`, and"
- " :const:`TIPC_NODE_SCOPE`."
- msgstr ""
- # 7957cc3c432345f18edd34a599d7ccba
- #: ../../library/socket.rst:85
- msgid ""
- "If *addr_type* is :const:`TIPC_ADDR_NAME`, then *v1* is the server type, "
- "*v2* is the port identifier, and *v3* should be 0."
- msgstr ""
- # c903c568e4c743a18376a595f02ada26
- #: ../../library/socket.rst:88
- msgid ""
- "If *addr_type* is :const:`TIPC_ADDR_NAMESEQ`, then *v1* is the server type, "
- "*v2* is the lower port number, and *v3* is the upper port number."
- msgstr ""
- # 66c93722656749978b3884ced870def9
- # 3d8854372122489aa178015476388c81
- #: ../../library/socket.rst:91 ../../library/socket.rst:94
- msgid ""
- "If *addr_type* is :const:`TIPC_ADDR_ID`, then *v1* is the node, *v2* is the "
- "reference, and *v3* should be set to 0."
- msgstr ""
- # 866f02d98b2d4b86ab8c25706897e5af
- #: ../../library/socket.rst:97
- msgid ""
- "A tuple ``(interface, )`` is used for the :const:`AF_CAN` address family, "
- "where *interface* is a string representing a network interface name like "
- "``'can0'``. The network interface name ``''`` can be used to receive packets"
- " from all network interfaces of this family."
- msgstr ""
- # fc3c4663cfb9404eabf6c14fe10f8a5b
- #: ../../library/socket.rst:102
- msgid ""
- "A string or a tuple ``(id, unit)`` is used for the :const:`SYSPROTO_CONTROL`"
- " protocol of the :const:`PF_SYSTEM` family. The string is the name of a "
- "kernel control using a dynamically-assigned ID. The tuple can be used if ID "
- "and unit number of the kernel control are known or if a registered ID is "
- "used."
- msgstr ""
- # 2479e37fd40c408e969e04c6e8e8a6d3
- #: ../../library/socket.rst:110
- msgid ""
- "Certain other address families (:const:`AF_BLUETOOTH`, :const:`AF_PACKET`) "
- "support specific representations."
- msgstr ""
- # 3226490d328442d98e294780fdb05429
- #: ../../library/socket.rst:115
- msgid ""
- "For IPv4 addresses, two special forms are accepted instead of a host "
- "address: the empty string represents :const:`INADDR_ANY`, and the string "
- "``'<broadcast>'`` represents :const:`INADDR_BROADCAST`. This behavior is "
- "not compatible with IPv6, therefore, you may want to avoid these if you "
- "intend to support IPv6 with your Python programs."
- msgstr ""
- # 0f932973a17e4bafbb65b8560c23553d
- #: ../../library/socket.rst:121
- msgid ""
- "If you use a hostname in the *host* portion of IPv4/v6 socket address, the "
- "program may show a nondeterministic behavior, as Python uses the first "
- "address returned from the DNS resolution. The socket address will be "
- "resolved differently into an actual IPv4/v6 address, depending on the "
- "results from DNS resolution and/or the host configuration. For "
- "deterministic behavior use a numeric address in *host* portion."
- msgstr "IPv4/v6ソケットの *host* 部にホスト名を指定すると、処理結果が一定ではない場合があります。これはPythonはDNSから取得したアドレスのうち最初のアドレスを使用するので、 DNSの処理やホストの設定によって異なるIPv4/6アドレスを取得する場合があるためです。常に同じ結果が必要であれば、 *host* に数値のアドレスを指定してください。"
- # 5f5a26b7db4a488d8b94af1ba28b351d
- #: ../../library/socket.rst:128
- msgid ""
- "All errors raise exceptions. The normal exceptions for invalid argument "
- "types and out-of-memory conditions can be raised; starting from Python 3.3, "
- "errors related to socket or address semantics raise :exc:`OSError` or one of"
- " its subclasses (they used to raise :exc:`socket.error`)."
- msgstr ""
- # c95723e1a2b44d98b69d8d89a621cb21
- #: ../../library/socket.rst:133
- msgid ""
- "Non-blocking mode is supported through :meth:`~socket.setblocking`. A "
- "generalization of this based on timeouts is supported through "
- ":meth:`~socket.settimeout`."
- msgstr ":meth:`~socket.setblocking` メソッドで、非ブロッキングモードを使用することができます。また、より汎用的に :meth:`~socket.settimeout` メソッドでタイムアウトを指定する事ができます。"
- # c774f0944c484502bf96c2b5ce07ce68
- #: ../../library/socket.rst:139
- msgid "Module contents"
- msgstr "モジュールの内容"
- # 7cd19c82a9bb4fe2bd40d368acf19240
- #: ../../library/socket.rst:141
- msgid "The module :mod:`socket` exports the following elements."
- msgstr ""
- # 794c39a39a3941119d1c606ae090be58
- #: ../../library/socket.rst:145
- msgid "Exceptions"
- msgstr "例外"
- # c3194afd41c8423bb4d47c74ab0ba35d
- #: ../../library/socket.rst:149
- msgid "A deprecated alias of :exc:`OSError`."
- msgstr ""
- # ef4928f7db6c41e78c390b16f15e07a7
- # 71118ae47376428ea68fb8120ad9b859
- #: ../../library/socket.rst:151 ../../library/socket.rst:151
- msgid "Following :pep:`3151`, this class was made an alias of :exc:`OSError`."
- msgstr ""
- # 3923e5f10d4749e2a7acc71ad543d14a
- #: ../../library/socket.rst:157
- msgid ""
- "A subclass of :exc:`OSError`, this exception is raised for address-related "
- "errors, i.e. for functions that use *h_errno* in the POSIX C API, including "
- ":func:`gethostbyname_ex` and :func:`gethostbyaddr`. The accompanying value "
- "is a pair ``(h_errno, string)`` representing an error returned by a library "
- "call. *h_errno* is a numeric value, while *string* represents the "
- "description of *h_errno*, as returned by the :c:func:`hstrerror` C function."
- msgstr ""
- # 4d701008711d49ed86e19fc540460417
- # d1ec22a46ee243f9b8111d39c3c1d43e
- # e2650f492cb14c8b84978b65ae8f7612
- # 0400c4612d67460ab25c7ae831d3aea9
- # d8fb49a1279e46f3855348b4ff60dea4
- # 02b3273a18384a169b13238f572826cf
- #: ../../library/socket.rst:165 ../../library/socket.rst:165
- #: ../../library/socket.rst:178 ../../library/socket.rst:178
- #: ../../library/socket.rst:189 ../../library/socket.rst:189
- msgid "This class was made a subclass of :exc:`OSError`."
- msgstr ""
- # b0d65754dfcc40c3b80ddb05161881db
- #: ../../library/socket.rst:170
- msgid ""
- "A subclass of :exc:`OSError`, this exception is raised for address-related "
- "errors by :func:`getaddrinfo` and :func:`getnameinfo`. The accompanying "
- "value is a pair ``(error, string)`` representing an error returned by a "
- "library call. *string* represents the description of *error*, as returned "
- "by the :c:func:`gai_strerror` C function. The numeric *error* value will "
- "match one of the :const:`EAI_\\*` constants defined in this module."
- msgstr ""
- # 1b58db6b4f21479aa49e62800ec4be1c
- #: ../../library/socket.rst:183
- msgid ""
- "A subclass of :exc:`OSError`, this exception is raised when a timeout occurs"
- " on a socket which has had timeouts enabled via a prior call to "
- ":meth:`~socket.settimeout` (or implicitly through "
- ":func:`~socket.setdefaulttimeout`). The accompanying value is a string "
- "whose value is currently always \"timed out\"."
- msgstr ""
- # 35283adb7130476e834a20e97ad0da33
- #: ../../library/socket.rst:194
- msgid "Constants"
- msgstr "定数"
- # b0a4f1d27da446b48f1fcea348ecbf78
- #: ../../library/socket.rst:200
- msgid ""
- "These constants represent the address (and protocol) families, used for the "
- "first argument to :func:`.socket`. If the :const:`AF_UNIX` constant is not "
- "defined then this protocol is unsupported. More constants may be available "
- "depending on the system."
- msgstr ""
- # 3e241f0c8fdd4c2bad50d8974eb4a4df
- #: ../../library/socket.rst:212
- msgid ""
- "These constants represent the socket types, used for the second argument to "
- ":func:`.socket`. More constants may be available depending on the system. "
- "(Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to be generally "
- "useful.)"
- msgstr ""
- # d03f8b97cc2c4fb6ba04feef70ccfe61
- #: ../../library/socket.rst:220
- msgid ""
- "These two constants, if defined, can be combined with the socket types and "
- "allow you to set some flags atomically (thus avoiding possible race "
- "conditions and the need for separate calls)."
- msgstr ""
- # 3e4f897695cb44978c610ec567f67005
- #: ../../library/socket.rst:226
- msgid ""
- "`Secure File Descriptor Handling "
- "<http://udrepper.livejournal.com/20407.html>`_ for a more thorough "
- "explanation."
- msgstr ""
- # 0666bebc969947ac8b299f164398a3c6
- #: ../../library/socket.rst:229
- msgid "Availability: Linux >= 2.6.27."
- msgstr ""
- # 9cf14a3caa5c48d3b25208f963ed065a
- #: ../../library/socket.rst:248
- msgid ""
- "Many constants of these forms, documented in the Unix documentation on "
- "sockets and/or the IP protocol, are also defined in the socket module. They "
- "are generally used in arguments to the :meth:`setsockopt` and "
- ":meth:`getsockopt` methods of socket objects. In most cases, only those "
- "symbols that are defined in the Unix header files are defined; for a few "
- "symbols, default values are provided."
- msgstr "Unixのソケット・IPプロトコルのドキュメントで定義されている各種定数。ソケットオブジェクトの :meth:`setsockopt` や :meth:`getsockopt` で使用します。ほとんどのシンボルはUnixのヘッダファイルに従っています。一部のシンボルには、デフォルト値を定義してあります。"
- # a8b7601b2a574d7ba229aa1ca6215fc0
- # eb8f2abf858f49178a923f807b693c76
- #: ../../library/socket.rst:260 ../../library/socket.rst:273
- msgid ""
- "Many constants of these forms, documented in the Linux documentation, are "
- "also defined in the socket module."
- msgstr ""
- # 4d0156314e434366bb56040b9bc9f745
- #: ../../library/socket.rst:263
- msgid "Availability: Linux >= 2.6.25."
- msgstr ""
- # 67717c2e6b6d4b038be2b9a11d90cd81
- #: ../../library/socket.rst:276
- msgid "Availability: Linux >= 2.6.30."
- msgstr ""
- # 5331acc939604d8e90d4581ef08eebe7
- #: ../../library/socket.rst:284
- msgid ""
- "Constants for Windows' WSAIoctl(). The constants are used as arguments to "
- "the :meth:`~socket.socket.ioctl` method of socket objects."
- msgstr ""
- # 616e56fdfc4b4448becdf7a72750d6b8
- #: ../../library/socket.rst:290
- msgid ""
- "TIPC related constants, matching the ones exported by the C socket API. See "
- "the TIPC documentation for more information."
- msgstr "TIPC関連の定数で、CのソケットAPIが公開しているものにマッチします。詳しい情報はTIPCのドキュメントを参照してください。"
- # 25af97962a14423a9892e71de631222f
- #: ../../library/socket.rst:296
- msgid ""
- "This constant contains a boolean value which indicates if IPv6 is supported "
- "on this platform."
- msgstr "現在のプラットフォームでIPv6がサポートされているか否かを示す真偽値。"
- # 362a45435dec4d58bd5fea524321365c
- #: ../../library/socket.rst:301
- msgid "Functions"
- msgstr "関数"
- # 835ebd3f13df480f89912e958e4d7d81
- #: ../../library/socket.rst:304
- msgid "Creating sockets"
- msgstr ""
- # 753ee6a7680b4931ae38bc074cb63167
- #: ../../library/socket.rst:306
- msgid ""
- "The following functions all create :ref:`socket objects <socket-objects>`."
- msgstr ""
- # 01fd05421dde4008ad2fbe3acd359b22
- #: ../../library/socket.rst:311
- msgid ""
- "Create a new socket using the given address family, socket type and protocol"
- " number. The address family should be :const:`AF_INET` (the default), "
- ":const:`AF_INET6`, :const:`AF_UNIX`, :const:`AF_CAN` or :const:`AF_RDS`. The"
- " socket type should be :const:`SOCK_STREAM` (the default), "
- ":const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other ``SOCK_``"
- " constants. The protocol number is usually zero and may be omitted in that "
- "case or :const:`CAN_RAW` in case the address family is :const:`AF_CAN`."
- msgstr ""
- # 3401694d32bb4f9081d0274ac0c79ac1
- # c27cbef8d1094640ac3057b51518b17f
- #: ../../library/socket.rst:319 ../../library/socket.rst:319
- msgid "The AF_CAN family was added. The AF_RDS family was added."
- msgstr ""
- # 152d725f41544ad6ad60b98bc9b546c3
- #: ../../library/socket.rst:326
- msgid ""
- "Build a pair of connected socket objects using the given address family, "
- "socket type, and protocol number. Address family, socket type, and protocol"
- " number are as for the :func:`.socket` function above. The default family is"
- " :const:`AF_UNIX` if defined on the platform; otherwise, the default is "
- ":const:`AF_INET`. Availability: Unix."
- msgstr ""
- # f043ae2a027d42348c1cf94a789360d1
- # 29e4cd5fc3f14c4482de1c86601cbcf3
- #: ../../library/socket.rst:332 ../../library/socket.rst:332
- msgid ""
- "The returned socket objects now support the whole socket API, rather than a "
- "subset."
- msgstr ""
- # 449eb6e3756e4738b87c8cbf7e881f9a
- #: ../../library/socket.rst:339
- msgid ""
- "Connect to a TCP service listening on the Internet *address* (a 2-tuple "
- "``(host, port)``), and return the socket object. This is a higher-level "
- "function than :meth:`socket.connect`: if *host* is a non-numeric hostname, "
- "it will try to resolve it for both :data:`AF_INET` and :data:`AF_INET6`, and"
- " then try to connect to all possible addresses in turn until a connection "
- "succeeds. This makes it easy to write clients that are compatible to both "
- "IPv4 and IPv6."
- msgstr ""
- # cdb44a8c3cdf4796a12d7b3d187a6eb3
- #: ../../library/socket.rst:347
- msgid ""
- "Passing the optional *timeout* parameter will set the timeout on the socket "
- "instance before attempting to connect. If no *timeout* is supplied, the "
- "global default timeout setting returned by :func:`getdefaulttimeout` is "
- "used."
- msgstr ""
- # dc53c6683e1d4da78e5f7fc3743a78a2
- #: ../../library/socket.rst:352
- msgid ""
- "If supplied, *source_address* must be a 2-tuple ``(host, port)`` for the "
- "socket to bind to as its source address before connecting. If host or port "
- "are '' or 0 respectively the OS default behavior will be used."
- msgstr "*source_address* は接続する前にバインドするソースアドレスを指定するオプション引数で、指定する場合は ``(host, port)`` の2要素タプルでなければなりません。 host や port が '' か 0 だった場合は、OSのデフォルトの動作になります。"
- # cb83de96360d4e0c99b8102107afcc2d
- # 1819757f05474ac09855e9cd02b8979c
- #: ../../library/socket.rst:356 ../../library/socket.rst:356
- msgid "*source_address* was added."
- msgstr ""
- # 6c9d7f3f9ade4eeea80dfb149ee622b7
- # e130458cea094d21968dc29c97b1a85d
- #: ../../library/socket.rst:359 ../../library/socket.rst:359
- msgid "support for the :keyword:`with` statement was added."
- msgstr ""
- # d7d789a65eb54041bdbe10afdd39ee16
- #: ../../library/socket.rst:365
- msgid ""
- "Duplicate the file descriptor *fd* (an integer as returned by a file "
- "object's :meth:`fileno` method) and build a socket object from the result. "
- "Address family, socket type and protocol number are as for the "
- ":func:`.socket` function above. The file descriptor should refer to a "
- "socket, but this is not checked --- subsequent operations on the object may "
- "fail if the file descriptor is invalid. This function is rarely needed, but "
- "can be used to get or set socket options on a socket passed to a program as "
- "standard input or output (such as a server started by the Unix inet daemon)."
- " The socket is assumed to be in blocking mode."
- msgstr ""
- # ca61177b87d54d7793dfde97f4947a00
- #: ../../library/socket.rst:377
- msgid ""
- "Instantiate a socket from data obtained from the :meth:`socket.share` "
- "method. The socket is assumed to be in blocking mode."
- msgstr ""
- # 72a929a423ba4193aa0ab137386f501b
- # 9844d838e42046658498e904bd7478bb
- #: ../../library/socket.rst:380 ../../library/socket.rst:1138
- msgid "Availability: Windows."
- msgstr "利用できる環境: Windows。"
- # a4955338259c4563b747e62cf5dbb64c
- #: ../../library/socket.rst:387
- msgid ""
- "This is a Python type object that represents the socket object type. It is "
- "the same as ``type(socket(...))``."
- msgstr "ソケットオブジェクトの型を示す型オブジェクト。 ``type(socket(...))`` と同じです。"
- # dbaa8586481843c79efac190a41e8fcd
- #: ../../library/socket.rst:392
- msgid "Other functions"
- msgstr "その他の関数"
- # 64e4d449642c45e991258e31301ccd9f
- #: ../../library/socket.rst:394
- msgid "The :mod:`socket` module also offers various network-related services:"
- msgstr ""
- # da95fc2fbc8f4abab60e3b277feef5cd
- #: ../../library/socket.rst:399
- msgid ""
- "Translate the *host*/*port* argument into a sequence of 5-tuples that "
- "contain all the necessary arguments for creating a socket connected to that "
- "service. *host* is a domain name, a string representation of an IPv4/v6 "
- "address or ``None``. *port* is a string service name such as ``'http'``, a "
- "numeric port number or ``None``. By passing ``None`` as the value of *host*"
- " and *port*, you can pass ``NULL`` to the underlying C API."
- msgstr "*host* / *port* 引数の指すアドレス情報を、そのサービスに接続されたソケットを作成するために必要な全ての引数が入った 5 要素のタプルに変換します。 *host* はドメイン名、IPv4/v6アドレスの文字列、または ``None`` です。 *port* は ``'http'`` のようなサービス名文字列、ポート番号を表す数値、または ``None`` です。 *host* と *port* に ``None`` を指定すると C APIに ``NULL`` を渡せます。"
- # 489143df472e4e859ef3ab7f529b9a80
- #: ../../library/socket.rst:406
- msgid ""
- "The *family*, *type* and *proto* arguments can be optionally specified in "
- "order to narrow the list of addresses returned. Passing zero as a value for"
- " each of these arguments selects the full range of results. The *flags* "
- "argument can be one or several of the ``AI_*`` constants, and will influence"
- " how results are computed and returned. For example, :const:`AI_NUMERICHOST`"
- " will disable domain name resolution and will raise an error if *host* is a "
- "domain name."
- msgstr "オプションの *family* 、 *type* 、 *proto* 引数を指定すると、返されるアドレスのリストを絞り込むことができます。これらの引数の値として 0 を渡すと絞る込まない結果を返します。 *flags* 引数には ``AI_*`` 定数のうち 1 つ以上が指定でき、結果の取り方を変えることができます。例えば、 :const:`AI_NUMERICHOST` を指定するとドメイン名解決を行わないようにし、 *host* がドメイン名だった場合には例外を送出します。"
- # d1e76ee0fdc14e21b0a6820244e4d0ac
- #: ../../library/socket.rst:414
- msgid "The function returns a list of 5-tuples with the following structure:"
- msgstr "この関数は以下の構造をとる 5 要素のタプルのリストを返します:"
- # c2118a5739b04e3d9e89ffdf933f848c
- #: ../../library/socket.rst:416
- msgid "``(family, type, proto, canonname, sockaddr)``"
- msgstr "``(family, type, proto, canonname, sockaddr)``"
- # 7febe568470a4942a2c2dd356940b655
- #: ../../library/socket.rst:418
- msgid ""
- "In these tuples, *family*, *type*, *proto* are all integers and are meant to"
- " be passed to the :func:`.socket` function. *canonname* will be a string "
- "representing the canonical name of the *host* if :const:`AI_CANONNAME` is "
- "part of the *flags* argument; else *canonname* will be empty. *sockaddr* is"
- " a tuple describing a socket address, whose format depends on the returned "
- "*family* (a ``(address, port)`` 2-tuple for :const:`AF_INET`, a ``(address, "
- "port, flow info, scope id)`` 4-tuple for :const:`AF_INET6`), and is meant to"
- " be passed to the :meth:`socket.connect` method."
- msgstr ""
- # be7b0aa0798b4b8da184a7cf9f72232b
- #: ../../library/socket.rst:428
- msgid ""
- "The following example fetches address information for a hypothetical TCP "
- "connection to ``www.python.org`` on port 80 (results may differ on your "
- "system if IPv6 isn't enabled)::"
- msgstr "次の例では ``www.python.org`` の 80 番ポートポートへの TCP 接続を得るためのアドレス情報を取得しようとしています。 (結果は IPv6 をサポートしているかどうかで変わります)::"
- # cb89a38f99fc410d9b8ef7ba3842faf1
- # ec16915d80054df3a9785e36eea0046d
- #: ../../library/socket.rst:436 ../../library/socket.rst:436
- msgid "parameters can now be passed as single keyword arguments."
- msgstr ""
- # 53615f9f9a514d4e91a5a6c4d85de182
- #: ../../library/socket.rst:441
- msgid ""
- "Return a fully qualified domain name for *name*. If *name* is omitted or "
- "empty, it is interpreted as the local host. To find the fully qualified "
- "name, the hostname returned by :func:`gethostbyaddr` is checked, followed by"
- " aliases for the host, if available. The first name which includes a period"
- " is selected. In case no fully qualified domain name is available, the "
- "hostname as returned by :func:`gethostname` is returned."
- msgstr "*name* の完全修飾ドメイン名を返します。 *name* が空または省略された場合、ローカルホストを指定したとみなします。完全修飾ドメイン名の取得にはまず :func:`gethostbyaddr` でチェックし、次に可能であればエイリアスを調べ、名前にピリオドを含む最初の名前を値として返します。完全修飾ドメイン名を取得できない場合、 :func:`gethostname` で返されるホスト名を返します。"
- # 0eeaa94d5dd549d0b8488287730b7a36
- #: ../../library/socket.rst:451
- msgid ""
- "Translate a host name to IPv4 address format. The IPv4 address is returned "
- "as a string, such as ``'100.50.200.5'``. If the host name is an IPv4 "
- "address itself it is returned unchanged. See :func:`gethostbyname_ex` for a"
- " more complete interface. :func:`gethostbyname` does not support IPv6 name "
- "resolution, and :func:`getaddrinfo` should be used instead for IPv4/v6 dual "
- "stack support."
- msgstr "ホスト名を ``'100.50.200.5'`` のようなIPv4形式のアドレスに変換します。ホスト名としてIPv4アドレスを指定した場合、その値は変換せずにそのまま返ります。 :func:`gethostbyname` APIへのより完全なインターフェースが必要であれば、 :func:`gethostbyname_ex` を参照してください。 :func:`gethostbyname` は、IPv6名前解決をサポートしていません。IPv4/ v6のデュアルスタックをサポートする場合は :func:`getaddrinfo` を使用します。"
- # dd655c91490845618bfe2a8a55e8b73d
- #: ../../library/socket.rst:460
- msgid ""
- "Translate a host name to IPv4 address format, extended interface. Return a "
- "triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the primary"
- " host name responding to the given *ip_address*, *aliaslist* is a (possibly "
- "empty) list of alternative host names for the same address, and *ipaddrlist*"
- " is a list of IPv4 addresses for the same interface on the same host (often "
- "but not always a single address). :func:`gethostbyname_ex` does not support "
- "IPv6 name resolution, and :func:`getaddrinfo` should be used instead for "
- "IPv4/v6 dual stack support."
- msgstr "ホスト名から、IPv4形式の各種アドレス情報を取得します。戻り値は ``(hostname, aliaslist, ipaddrlist)`` のタプルで、 *hostname* は *ip_address* で指定したホストの正式名、 *aliaslist* は同じアドレスの別名のリスト(空の場合もある)、 *ipaddrlist* は同じホスト上の同一インターフェースのIPv4アドレスのリスト(ほとんどの場合は単一のアドレスのみ) を示します。 :func:`gethostbyname` は、IPv6名前解決をサポートしていません。IPv4/v6のデュアルスタックをサポートする場合は :func:`getaddrinfo` を使用します。"
- # 73e962c3b8a84a1483e8c26d4e210862
- #: ../../library/socket.rst:472
- msgid ""
- "Return a string containing the hostname of the machine where the Python "
- "interpreter is currently executing."
- msgstr "Pythonインタープリタを現在実行中のマシンのホスト名を示す文字列を取得します。"
- # f9b3d54e89994c15b1eef44bf705b4ba
- #: ../../library/socket.rst:475
- msgid ""
- "If you want to know the current machine's IP address, you may want to use "
- "``gethostbyname(gethostname())``. This operation assumes that there is a "
- "valid address-to-host mapping for the host, and the assumption does not "
- "always hold."
- msgstr "実行中マシンのIPアドレスが必要であれば、 ``gethostbyname(gethostname())`` を使用してください。この処理は実行中ホストのアドレス-ホスト名変換が可能であることを前提としていますが、常に変換可能であるとは限りません。"
- # 4ba246d1f849474d86bc633a1da6264e
- #: ../../library/socket.rst:480
- msgid ""
- "Note: :func:`gethostname` doesn't always return the fully qualified domain "
- "name; use ``getfqdn()`` (see above)."
- msgstr "注意: :func:`gethostname` は完全修飾ドメイン名を返すとは限りません。完全修飾ドメイン名が必要であれば、 ``gethostbyaddr(gethostname())`` としてください(下記参照)。"
- # cc34823a4f2d4e3284258a2109c11cac
- #: ../../library/socket.rst:486
- msgid ""
- "Return a triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is "
- "the primary host name responding to the given *ip_address*, *aliaslist* is a"
- " (possibly empty) list of alternative host names for the same address, and "
- "*ipaddrlist* is a list of IPv4/v6 addresses for the same interface on the "
- "same host (most likely containing only a single address). To find the fully "
- "qualified domain name, use the function :func:`getfqdn`. "
- ":func:`gethostbyaddr` supports both IPv4 and IPv6."
- msgstr "``(hostname, aliaslist, ipaddrlist)`` のタプルを返し、 *hostname* は *ip_address* で指定したホストの正式名、 ``aliaslist`` は同じアドレスの別名のリスト(空の場合もある)、 ``ipaddrlist`` は同じホスト上の同一インターフェースのIPv4アドレスのリスト(ほとんどの場合は単一のアドレスのみ)を示します。完全修飾ドメイン名が必要であれば、 :func:`getfqdn` を使用してください。 :func:`gethostbyaddr` は、IPv4/IPv6の両方をサポートしています。"
- # 4be3c21ed1bf4d5faec1e42877dd9877
- #: ../../library/socket.rst:497
- msgid ""
- "Translate a socket address *sockaddr* into a 2-tuple ``(host, port)``. "
- "Depending on the settings of *flags*, the result can contain a fully-"
- "qualified domain name or numeric address representation in *host*. "
- "Similarly, *port* can contain a string port name or a numeric port number."
- msgstr "ソケットアドレス *sockaddr* から、 ``(host, port)`` のタプルを取得します。 *flags* の設定に従い、 *host* は完全修飾ドメイン名または数値形式アドレスとなります。同様に、 *port* は文字列のポート名または数値のポート番号となります。"
- # f2b5ad4679104aafb1abe480034a5ed3
- #: ../../library/socket.rst:505
- msgid ""
- "Translate an Internet protocol name (for example, ``'icmp'``) to a constant "
- "suitable for passing as the (optional) third argument to the :func:`.socket`"
- " function. This is usually only needed for sockets opened in \"raw\" mode "
- "(:const:`SOCK_RAW`); for the normal socket modes, the correct protocol is "
- "chosen automatically if the protocol is omitted or zero."
- msgstr ""
- # 39f75d9eb9264692918f671d6be390ec
- #: ../../library/socket.rst:514
- msgid ""
- "Translate an Internet service name and protocol name to a port number for "
- "that service. The optional protocol name, if given, should be ``'tcp'`` or "
- "``'udp'``, otherwise any protocol will match."
- msgstr "インターネットサービス名とプロトコルから、そのサービスのポート番号を取得します。省略可能なプロトコル名として、 ``'tcp'`` か ``'udp'`` のどちらかを指定することができます。指定がなければどちらのプロトコルにもマッチします。"
- # dfa9f40b690d43d28e0e8c17f46d558d
- #: ../../library/socket.rst:521
- msgid ""
- "Translate an Internet port number and protocol name to a service name for "
- "that service. The optional protocol name, if given, should be ``'tcp'`` or "
- "``'udp'``, otherwise any protocol will match."
- msgstr "インターネットポート番号とプロトコル名から、サービス名を取得します。省略可能なプロトコル名として、 ``'tcp'`` か ``'udp'`` のどちらかを指定することができます。指定がなければどちらのプロトコルにもマッチします。"
- # 6feb402444d24f65abaaf1abffed0706
- #: ../../library/socket.rst:528
- msgid ""
- "Convert 32-bit positive integers from network to host byte order. On "
- "machines where the host byte order is the same as network byte order, this "
- "is a no-op; otherwise, it performs a 4-byte swap operation."
- msgstr "32ビットの正の整数のバイトオーダを、ネットワークバイトオーダからホストバイトオーダに変換します。ホストバイトオーダとネットワークバイトオーダが一致するマシンでは、この関数は何もしません。それ以外の場合は4バイトのスワップを行います。"
- # 51d2994311c940e98aff17b5e3eceb59
- #: ../../library/socket.rst:535
- msgid ""
- "Convert 16-bit positive integers from network to host byte order. On "
- "machines where the host byte order is the same as network byte order, this "
- "is a no-op; otherwise, it performs a 2-byte swap operation."
- msgstr "16ビットの正の整数のバイトオーダを、ネットワークバイトオーダからホストバイトオーダに変換します。ホストバイトオーダとネットワークバイトオーダが一致するマシンでは、この関数は何もしません。それ以外の場合は2バイトのスワップを行います。"
- # 02fc05e64a7a4e179f851a8cd5551949
- #: ../../library/socket.rst:542
- msgid ""
- "Convert 32-bit positive integers from host to network byte order. On "
- "machines where the host byte order is the same as network byte order, this "
- "is a no-op; otherwise, it performs a 4-byte swap operation."
- msgstr "32ビットの正の整数のバイトオーダを、ホストバイトオーダからネットワークバイトオーダに変換します。ホストバイトオーダとネットワークバイトオーダが一致するマシンでは、この関数は何もしません。それ以外の場合は4バイトのスワップを行います。"
- # 2da3fa52c4c844c8989fa36a226813cc
- #: ../../library/socket.rst:549
- msgid ""
- "Convert 16-bit positive integers from host to network byte order. On "
- "machines where the host byte order is the same as network byte order, this "
- "is a no-op; otherwise, it performs a 2-byte swap operation."
- msgstr "16ビットの正の整数のバイトオーダを、ホストバイトオーダからネットワークバイトオーダに変換します。ホストバイトオーダとネットワークバイトオーダが一致するマシンでは、この関数は何もしません。それ以外の場合は2バイトのスワップを行います。"
- # eb512910712e407581ddf05254dc1a6c
- #: ../../library/socket.rst:556
- msgid ""
- "Convert an IPv4 address from dotted-quad string format (for example, "
- "'123.45.67.89') to 32-bit packed binary format, as a bytes object four "
- "characters in length. This is useful when conversing with a program that "
- "uses the standard C library and needs objects of type :c:type:`struct "
- "in_addr`, which is the C type for the 32-bit packed binary this function "
- "returns."
- msgstr "ドット記法によるIPv4アドレス(``'123.45.67.89'`` など)を32ビットにパックしたバイナリ形式に変換し、長さ4のバイト列オブジェクトとして返します。この関数が返す値は、標準Cライブラリの :c:type:`struct in_addr` 型を使用する関数に渡す事ができます。"
- # 77894199ecce4774b800266e819dcff8
- #: ../../library/socket.rst:562
- msgid ""
- ":func:`inet_aton` also accepts strings with less than three dots; see the "
- "Unix manual page :manpage:`inet(3)` for details."
- msgstr ":func:`inet_aton` はドットが 3 個以下の文字列も受け取ります; 詳細については Unix のマニュアル :manpage:`inet(3)` を参照してください。"
- # 13590d08f6b147a9b20216248d62e41b
- #: ../../library/socket.rst:565
- msgid ""
- "If the IPv4 address string passed to this function is invalid, "
- ":exc:`OSError` will be raised. Note that exactly what is valid depends on "
- "the underlying C implementation of :c:func:`inet_aton`."
- msgstr "IPv4アドレス文字列が不正であれば、 :exc:`OSError` が発生します。このチェックは、この関数で使用しているCの実装 :c:func:`inet_aton` で行われます。"
- # d7248f6947ed482b8f40956fd03f7bb0
- #: ../../library/socket.rst:569
- msgid ""
- ":func:`inet_aton` does not support IPv6, and :func:`inet_pton` should be "
- "used instead for IPv4/v6 dual stack support."
- msgstr ":func:`inet_aton` は、IPv6をサポートしません。IPv4/v6のデュアルスタックをサポートする場合は :func:`inet_pton` を使用します。"
- # 88f4e89caa4b4927af52a0c7cec1b204
- #: ../../library/socket.rst:575
- msgid ""
- "Convert a 32-bit packed IPv4 address (a bytes object four characters in "
- "length) to its standard dotted-quad string representation (for example, "
- "'123.45.67.89'). This is useful when conversing with a program that uses "
- "the standard C library and needs objects of type :c:type:`struct in_addr`, "
- "which is the C type for the 32-bit packed binary data this function takes as"
- " an argument."
- msgstr "32ビットにパックしたバイナリ形式のIPv4アドレスを、ドット記法による文字列 (``'123.45.67.89'`` など)に変換します。この関数が返す値は、標準Cライブラリの :c:type:`struct in_addr` 型を使用する関数に渡す事ができます。"
- # c7a0482928f04d11a6242e3cd1e59210
- #: ../../library/socket.rst:582
- msgid ""
- "If the byte sequence passed to this function is not exactly 4 bytes in "
- "length, :exc:`OSError` will be raised. :func:`inet_ntoa` does not support "
- "IPv6, and :func:`inet_ntop` should be used instead for IPv4/v6 dual stack "
- "support."
- msgstr "この関数に渡すバイトシーケンスの長さが4バイト以外であれば、 :exc:`socket.error` が発生します。 :func:`inet_ntoa` は、IPv6をサポートしません。IPv4/v6のデュアルスタックをサポートする場合は :func:`inet_pton` を使用します。"
- # 6a777f795b1b4bd7954cd86b699287f1
- #: ../../library/socket.rst:590
- msgid ""
- "Convert an IP address from its family-specific string format to a packed, "
- "binary format. :func:`inet_pton` is useful when a library or network "
- "protocol calls for an object of type :c:type:`struct in_addr` (similar to "
- ":func:`inet_aton`) or :c:type:`struct in6_addr`."
- msgstr "IPアドレスを、アドレスファミリ固有の文字列からパックしたバイナリ形式に変換します。 :func:`inet_pton` は、 :c:type:`struct in_addr` 型 (:func:`inet_aton` と同様)や :c:type:`struct in6_addr` を使用するライブラリやネットワークプロトコルを呼び出す際に使用することができます。"
- # 0c4640629bff48f09f1aa1ca94bf49de
- #: ../../library/socket.rst:595
- msgid ""
- "Supported values for *address_family* are currently :const:`AF_INET` and "
- ":const:`AF_INET6`. If the IP address string *ip_string* is invalid, "
- ":exc:`OSError` will be raised. Note that exactly what is valid depends on "
- "both the value of *address_family* and the underlying implementation of "
- ":c:func:`inet_pton`."
- msgstr "現在サポートされている *address_family* は、 :const:`AF_INET` と :const:`AF_INET6` です。 *ip_string* に不正なIPアドレス文字列を指定すると、 :exc:`OSError` が発生します。有効な *ip_string* は、 *address_family* と :c:func:`inet_pton` の実装によって異なります。"
- # f0882252f5a54686a324dba6a32541f9
- # 935f331356564bd5a2bbe00d93d55640
- #: ../../library/socket.rst:601 ../../library/socket.rst:617
- msgid "Availability: Unix (maybe not all platforms)."
- msgstr "利用可能: Unix (サポートしていないプラットフォームもあります)。"
- # 2f3ee5780b494362bbfcb75f7003955d
- #: ../../library/socket.rst:606
- msgid ""
- "Convert a packed IP address (a bytes object of some number of characters) to"
- " its standard, family-specific string representation (for example, "
- "``'7.10.0.5'`` or ``'5aef:2b::8'``). :func:`inet_ntop` is useful when a "
- "library or network protocol returns an object of type :c:type:`struct "
- "in_addr` (similar to :func:`inet_ntoa`) or :c:type:`struct in6_addr`."
- msgstr "パックしたIPアドレス(数文字のバイト列オブジェクト)を、 ``'7.10.0.5'`` や ``'5aef:2b::8'`` などの標準的な、アドレスファミリ固有の文字列形式に変換します。 :func:`inet_ntop` は(:func:`inet_ntoa` と同様に) :c:type:`struct in_addr` 型や :c:type:`struct in6_addr` 型のオブジェクトを返すライブラリやネットワークプロトコル等で使用することができます。"
- # 8241745c11774039a84ac2f1ccff07c3
- #: ../../library/socket.rst:612
- msgid ""
- "Supported values for *address_family* are currently :const:`AF_INET` and "
- ":const:`AF_INET6`. If the string *packed_ip* is not the correct length for "
- "the specified address family, :exc:`ValueError` will be raised. A "
- ":exc:`OSError` is raised for errors from the call to :func:`inet_ntop`."
- msgstr "現在サポートされている *address_family* は、 :const:`AF_INET` と :const:`AF_INET6` です。 *packed_ip* の長さが指定したアドレスファミリで適切な長さでなければ、 :exc:`ValueError` が発生します。 :func:`inet_ntop` でエラーとなると、 :exc:`OSError` が発生します。"
- # a6fe65cc7b674e579c4ed5dfe76e6f32
- #: ../../library/socket.rst:628
- msgid ""
- "Return the total length, without trailing padding, of an ancillary data item"
- " with associated data of the given *length*. This value can often be used "
- "as the buffer size for :meth:`~socket.recvmsg` to receive a single item of "
- "ancillary data, but :rfc:`3542` requires portable applications to use "
- ":func:`CMSG_SPACE` and thus include space for padding, even when the item "
- "will be the last in the buffer. Raises :exc:`OverflowError` if *length* is "
- "outside the permissible range of values."
- msgstr ""
- # dcda93aaf72f45678c4eda611aea023d
- # 92c323796ea94a588a30005d363bb08b
- # eb26b0bbf1d74685a8e1257cee7d0066
- # 0747488eeddd4554a4bf6417c57bb72b
- # 53eea693d11149469d5673a5fb8ce6c0
- #: ../../library/socket.rst:637 ../../library/socket.rst:658
- #: ../../library/socket.rst:959 ../../library/socket.rst:996
- #: ../../library/socket.rst:1080
- msgid "Availability: most Unix platforms, possibly others."
- msgstr ""
- # 0f01b2f732fe469a8b1ab634e996af97
- #: ../../library/socket.rst:644
- msgid ""
- "Return the buffer size needed for :meth:`~socket.recvmsg` to receive an "
- "ancillary data item with associated data of the given *length*, along with "
- "any trailing padding. The buffer space needed to receive multiple items is "
- "the sum of the :func:`CMSG_SPACE` values for their associated data lengths."
- " Raises :exc:`OverflowError` if *length* is outside the permissible range "
- "of values."
- msgstr ""
- # 79b7af29103f4afdb3e62d6818ad1e2d
- #: ../../library/socket.rst:652
- msgid ""
- "Note that some systems might support ancillary data without providing this "
- "function. Also note that setting the buffer size using the results of this "
- "function may not precisely limit the amount of ancillary data that can be "
- "received, since additional data may be able to fit into the padding area."
- msgstr ""
- # 7336abb70ff24b9091bf7758b23634d9
- #: ../../library/socket.rst:665
- msgid ""
- "Return the default timeout in seconds (float) for new socket objects. A "
- "value of ``None`` indicates that new socket objects have no timeout. When "
- "the socket module is first imported, the default is ``None``."
- msgstr "新規に生成されたソケットオブジェクトの、デフォルトのタイムアウト値を秒数(浮動小数点形式)で返します。タイプアウトを使用しない場合には ``None`` を返します。最初にsocketモジュールがインポートされた時の初期値は ``None`` です。"
- # 94e8cf3e042246f4a04f0d1456cfc3cd
- #: ../../library/socket.rst:672
- msgid ""
- "Set the default timeout in seconds (float) for new socket objects. When the"
- " socket module is first imported, the default is ``None``. See "
- ":meth:`~socket.settimeout` for possible values and their respective "
- "meanings."
- msgstr ""
- # 4244f00c68d746358130362fb9c7288b
- #: ../../library/socket.rst:680
- msgid ""
- "Set the machine's hostname to *name*. This will raise a :exc:`OSError` if "
- "you don't have enough rights."
- msgstr ""
- # 7ff272ba99f34ea7abe9a3ca38af8ef0
- # 9b5e7820356d43e39df8686108cceab4
- # 81051ee7ca9147c8a5598a69608a8ee0
- # ec27d109f63d43bfaea94f5ff4095dd2
- #: ../../library/socket.rst:683 ../../library/socket.rst:694
- #: ../../library/socket.rst:705 ../../library/socket.rst:716
- msgid "Availability: Unix."
- msgstr "利用できる環境: Unix。"
- # 499186d8a19e424196679c97e8332bd0
- #: ../../library/socket.rst:690
- msgid ""
- "Return a list of network interface information (index int, name string) "
- "tuples. :exc:`OSError` if the system call fails."
- msgstr ""
- # c4ebcac498a44d64a88b5ee61b65dae1
- #: ../../library/socket.rst:701
- msgid ""
- "Return a network interface index number corresponding to an interface name. "
- ":exc:`OSError` if no interface with the given name exists."
- msgstr ""
- # 8a227c2f2674493aa34f32046016bee1
- #: ../../library/socket.rst:712
- msgid ""
- "Return a network interface name corresponding to a interface index number. "
- ":exc:`OSError` if no interface with the given index exists."
- msgstr ""
- # 11b8514d5b9945a58292ba4d238f92da
- #: ../../library/socket.rst:724
- msgid "Socket Objects"
- msgstr "socket オブジェクト"
- # 313bd9e858854a2f9f183b8cf6f2b2b1
- #: ../../library/socket.rst:726
- msgid ""
- "Socket objects have the following methods. Except for "
- ":meth:`~socket.makefile`, these correspond to Unix system calls applicable "
- "to sockets."
- msgstr ""
- # 4030753db7f24dcfaa5c3f54d95b64e7
- #: ../../library/socket.rst:733
- msgid ""
- "Accept a connection. The socket must be bound to an address and listening "
- "for connections. The return value is a pair ``(conn, address)`` where *conn*"
- " is a *new* socket object usable to send and receive data on the connection,"
- " and *address* is the address bound to the socket on the other end of the "
- "connection."
- msgstr "接続を受け付けます。ソケットはアドレスにbind済みで、listen中である必要があります。戻り値は ``(conn, address)`` のペアで、 *conn* は接続を通じてデータの送受信を行うための *新しい* ソケットオブジェクト、 *address* は接続先でソケットにbindしているアドレスを示します。"
- # d64015cae7e2423d926ad0f54eb4e8e6
- #: ../../library/socket.rst:741
- msgid ""
- "Bind the socket to *address*. The socket must not already be bound. (The "
- "format of *address* depends on the address family --- see above.)"
- msgstr "ソケットを *address* にbindします。bind済みのソケットを再バインドする事はできません。 *address* のフォーマットはアドレスファミリによって異なります(前述)。"
- # 0af312f00fa14d46856f5f106c7fc889
- #: ../../library/socket.rst:747
- msgid ""
- "Mark the socket closed. The underlying system resource (e.g. a file "
- "descriptor) is also closed when all file objects from :meth:`makefile()` are"
- " closed. Once that happens, all future operations on the socket object will"
- " fail. The remote end will receive no more data (after queued data is "
- "flushed)."
- msgstr ""
- # c1dcb96692954d88af9f4164f5ab17dd
- #: ../../library/socket.rst:753
- msgid ""
- "Sockets are automatically closed when they are garbage-collected, but it is "
- "recommended to :meth:`close` them explicitly, or to use a :keyword:`with` "
- "statement around them."
- msgstr ""
- # 8e55a10cfc0b4eda9e15f598e2b071d8
- #: ../../library/socket.rst:758
- msgid ""
- ":meth:`close()` releases the resource associated with a connection but does "
- "not necessarily close the connection immediately. If you want to close the "
- "connection in a timely fashion, call :meth:`shutdown()` before "
- ":meth:`close()`."
- msgstr ""
- # 13f2a08413d14fe59c1f42cd9273eb48
- #: ../../library/socket.rst:766
- msgid ""
- "Connect to a remote socket at *address*. (The format of *address* depends on"
- " the address family --- see above.)"
- msgstr "*address* で示されるリモートソケットに接続します。 *address* のフォーマットはアドレスファミリによって異なります(前述)。"
- # 82a7a5b413ea4b0a97175133f1e3f216
- #: ../../library/socket.rst:772
- msgid ""
- "Like ``connect(address)``, but return an error indicator instead of raising "
- "an exception for errors returned by the C-level :c:func:`connect` call "
- "(other problems, such as \"host not found,\" can still raise exceptions). "
- "The error indicator is ``0`` if the operation succeeded, otherwise the value"
- " of the :c:data:`errno` variable. This is useful to support, for example, "
- "asynchronous connects."
- msgstr "``connect(address)`` と同様ですが、C言語の :c:func:`connect` 関数の呼び出しでエラーが発生した場合には例外を送出せずにエラーを戻り値として返します。(これ以外の、\"host not found,\"等のエラーの場合には例外が発生します。)処理が正常に終了した場合には ``0`` を返し、エラー時には :c:data:`errno` の値を返します。この関数は、非同期接続をサポートする場合などに使用することができます。"
- # ff02c80cdc4a4c95bee3265b763f0fff
- #: ../../library/socket.rst:782
- msgid ""
- "Put the socket object into closed state without actually closing the "
- "underlying file descriptor. The file descriptor is returned, and can be "
- "reused for other purposes."
- msgstr ""
- # 8b867688b5aa4a2c96070cf7f36b2c58
- #: ../../library/socket.rst:791
- msgid ""
- "Return the socket's file descriptor (a small integer). This is useful with "
- ":func:`select.select`."
- msgstr "ソケットのファイルディスクリプタを整数型で返します。ファイルディスクリプタは、 :func:`select.select` などで使用します。"
- # 2fe6d2fd6a08493c99a03a2ea0a88f75
- #: ../../library/socket.rst:794
- msgid ""
- "Under Windows the small integer returned by this method cannot be used where"
- " a file descriptor can be used (such as :func:`os.fdopen`). Unix does not "
- "have this limitation."
- msgstr "Windowsではこのメソッドで返された小整数をファイルディスクリプタを扱う箇所(:func:`os.fdopen` など)で利用できません。 Unix にはこの制限はありません。"
- # b9877063f0fb4d909eafa1ffae517edb
- #: ../../library/socket.rst:801
- msgid ""
- "Return the remote address to which the socket is connected. This is useful "
- "to find out the port number of a remote IPv4/v6 socket, for instance. (The "
- "format of the address returned depends on the address family --- see above.)"
- " On some systems this function is not supported."
- msgstr "ソケットが接続しているリモートアドレスを返します。この関数は、リモート IPv4/v6ソケットのポート番号を調べる場合などに使用します。 *address* のフォーマットはアドレスファミリによって異なります(前述)。この関数をサポートしていないシステムも存在します。"
- # 89287c66e835478180c05d27af2b68da
- #: ../../library/socket.rst:809
- msgid ""
- "Return the socket's own address. This is useful to find out the port number"
- " of an IPv4/v6 socket, for instance. (The format of the address returned "
- "depends on the address family --- see above.)"
- msgstr "ソケット自身のアドレスを返します。この関数は、IPv4/v6ソケットのポート番号を調べる場合などに使用します。 *address* のフォーマットはアドレスファミリによって異なります(前述)。"
- # 62d1a36b7cde46efb1cf2b29567f232b
- #: ../../library/socket.rst:816
- msgid ""
- "Return the value of the given socket option (see the Unix man page "
- ":manpage:`getsockopt(2)`). The needed symbolic constants (:const:`SO_\\*` "
- "etc.) are defined in this module. If *buflen* is absent, an integer option "
- "is assumed and its integer value is returned by the function. If *buflen* "
- "is present, it specifies the maximum length of the buffer used to receive "
- "the option in, and this buffer is returned as a bytes object. It is up to "
- "the caller to decode the contents of the buffer (see the optional built-in "
- "module :mod:`struct` for a way to decode C structures encoded as byte "
- "strings)."
- msgstr "ソケットに指定されたオプションを返します(Unixのマニュアルページ :manpage:`getsockopt(2)` を参照)。 :const:`SO_\\*` 等のシンボルは、このモジュールで定義しています。 *buflen* を省略した場合、取得するオブションは整数とみなし、整数型の値を戻り値とします。 *buflen* を指定した場合、長さ *buflen* のバッファでオプションを受け取り、このバッファをバイト列オブジェクトとして返します。このバッファは、呼び出し元プログラムで :mod:`struct` モジュール等を利用して内容を読み取ることができます。"
- # b8ec909496b94c138472500bc131d5ad
- #: ../../library/socket.rst:828
- msgid ""
- "Return the timeout in seconds (float) associated with socket operations, or "
- "``None`` if no timeout is set. This reflects the last call to "
- ":meth:`setblocking` or :meth:`settimeout`."
- msgstr ""
- # 41b163af889b42239d009ed83709675f
- #: ../../library/socket.rst:835
- msgid "Windows"
- msgstr "Windows"
- # 04d06913140945bd8d93157b0e7c3ccd
- #: ../../library/socket.rst:837
- msgid ""
- "The :meth:`ioctl` method is a limited interface to the WSAIoctl system "
- "interface. Please refer to the `Win32 documentation "
- "<http://msdn.microsoft.com/en-us/library/ms741621%28VS.85%29.aspx>`_ for "
- "more information."
- msgstr ":meth:`ioctl` メソッドは WSAIoctl システムインタフェースへの制限されたインタフェースです。詳しい情報については、 `Win32 documentation <http://msdn.microsoft.com/en-us/library/ms741621%28VS.85%29.aspx>`_ を参照してください。"
- # 7a70db30b7b9461688295ab94800240a
- #: ../../library/socket.rst:842
- msgid ""
- "On other platforms, the generic :func:`fcntl.fcntl` and :func:`fcntl.ioctl` "
- "functions may be used; they accept a socket object as their first argument."
- msgstr "他のプラットフォームでは一般的な :func:`fcntl.fcntl` と :func:`fcntl.ioctl` が使われるでしょう; これらの関数は第 1 引数としてソケットオブジェクトを取ります。"
- # d42450bce7844b2d94d4be07dab670fb
- #: ../../library/socket.rst:847
- msgid ""
- "Listen for connections made to the socket. The *backlog* argument specifies"
- " the maximum number of queued connections and should be at least 0; the "
- "maximum value is system-dependent (usually 5), the minimum value is forced "
- "to 0."
- msgstr "ソケットをListenし、接続を待ちます。引数 *backlog* には接続キューの最大の長さ(0以上)を指定します。 *backlog* の最大数はシステムに依存します (通常は5)。最小値は必ず 0 です。"
- # 9b5f4c10ac4a46879b3b1d300ec5fbe4
- #: ../../library/socket.rst:857
- msgid ""
- "Return a :term:`file object` associated with the socket. The exact returned"
- " type depends on the arguments given to :meth:`makefile`. These arguments "
- "are interpreted the same way as by the built-in :func:`open` function."
- msgstr ""
- # 69d19d0595284b179729781630dbe4a2
- #: ../../library/socket.rst:861
- msgid ""
- "The socket must be in blocking mode; it can have a timeout, but the file "
- "object's internal buffer may end up in a inconsistent state if a timeout "
- "occurs."
- msgstr ""
- # da3712a18bf74483aedfc59cc32e3a77
- #: ../../library/socket.rst:865
- msgid ""
- "Closing the file object returned by :meth:`makefile` won't close the "
- "original socket unless all other file objects have been closed and "
- ":meth:`socket.close` has been called on the socket object."
- msgstr ""
- # 0db155f75b034bc3a62f246f3a108881
- #: ../../library/socket.rst:871
- msgid ""
- "On Windows, the file-like object created by :meth:`makefile` cannot be used "
- "where a file object with a file descriptor is expected, such as the stream "
- "arguments of :meth:`subprocess.Popen`."
- msgstr "Windows では、 :meth:`makefile` によって作成される file-like オブジェクトは、 :meth:`subprocess.Popen` などのファイルディスクリプタのある file オブジェクトを期待している場所で利用することはできません。"
- # d7385b182ced46be8ed5914f186a11c2
- #: ../../library/socket.rst:878
- msgid ""
- "Receive data from the socket. The return value is a bytes object "
- "representing the data received. The maximum amount of data to be received "
- "at once is specified by *bufsize*. See the Unix manual page "
- ":manpage:`recv(2)` for the meaning of the optional argument *flags*; it "
- "defaults to zero."
- msgstr ""
- # 3a21a12c1d6b4bef949750bb63ed4d76
- #: ../../library/socket.rst:885
- msgid ""
- "For best match with hardware and network realities, the value of *bufsize* "
- "should be a relatively small power of 2, for example, 4096."
- msgstr "ハードウェアおよびネットワークの現実に最大限マッチするように、 *bufsize* の値は比較的小さい2の累乗、たとえば 4096、にすべきです。"
- # 2147fdb7cd1e4c1f8b71739b40dc3e4f
- #: ../../library/socket.rst:891
- msgid ""
- "Receive data from the socket. The return value is a pair ``(bytes, "
- "address)`` where *bytes* is a bytes object representing the data received "
- "and *address* is the address of the socket sending the data. See the Unix "
- "manual page :manpage:`recv(2)` for the meaning of the optional argument "
- "*flags*; it defaults to zero. (The format of *address* depends on the "
- "address family --- see above.)"
- msgstr "ソケットからデータを受信し、結果をタプル ``(bytes, address)`` として返します。 *bytes* は受信データの文字列で、 *address* は送信元のアドレスを示します。オプション引数 *flags* については、 Unix のマニュアルページ :manpage:`recv(2)` を参照してください。デフォルトは0です。 (*address* のフォーマットはアドレスファミリによって異なります(前述))"
- # 6306a7f1169e464bb895df3d2b489a22
- #: ../../library/socket.rst:900
- msgid ""
- "Receive normal data (up to *bufsize* bytes) and ancillary data from the "
- "socket. The *ancbufsize* argument sets the size in bytes of the internal "
- "buffer used to receive the ancillary data; it defaults to 0, meaning that no"
- " ancillary data will be received. Appropriate buffer sizes for ancillary "
- "data can be calculated using :func:`CMSG_SPACE` or :func:`CMSG_LEN`, and "
- "items which do not fit into the buffer might be truncated or discarded. The"
- " *flags* argument defaults to 0 and has the same meaning as for "
- ":meth:`recv`."
- msgstr ""
- # 29b9c5ed6e0643329761fa30d09e63a7
- #: ../../library/socket.rst:910
- msgid ""
- "The return value is a 4-tuple: ``(data, ancdata, msg_flags, address)``. The"
- " *data* item is a :class:`bytes` object holding the non-ancillary data "
- "received. The *ancdata* item is a list of zero or more tuples "
- "``(cmsg_level, cmsg_type, cmsg_data)`` representing the ancillary data "
- "(control messages) received: *cmsg_level* and *cmsg_type* are integers "
- "specifying the protocol level and protocol-specific type respectively, and "
- "*cmsg_data* is a :class:`bytes` object holding the associated data. The "
- "*msg_flags* item is the bitwise OR of various flags indicating conditions on"
- " the received message; see your system documentation for details. If the "
- "receiving socket is unconnected, *address* is the address of the sending "
- "socket, if available; otherwise, its value is unspecified."
- msgstr ""
- # 83ccaf03fd4e4b92a801154e5a6edec2
- #: ../../library/socket.rst:924
- msgid ""
- "On some systems, :meth:`sendmsg` and :meth:`recvmsg` can be used to pass "
- "file descriptors between processes over an :const:`AF_UNIX` socket. When "
- "this facility is used (it is often restricted to :const:`SOCK_STREAM` "
- "sockets), :meth:`recvmsg` will return, in its ancillary data, items of the "
- "form ``(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)``, where *fds* is a "
- ":class:`bytes` object representing the new file descriptors as a binary "
- "array of the native C :c:type:`int` type. If :meth:`recvmsg` raises an "
- "exception after the system call returns, it will first attempt to close any "
- "file descriptors received via this mechanism."
- msgstr ""
- # bb2310be58de456f8237f2c1be1dd110
- #: ../../library/socket.rst:935
- msgid ""
- "Some systems do not indicate the truncated length of ancillary data items "
- "which have been only partially received. If an item appears to extend "
- "beyond the end of the buffer, :meth:`recvmsg` will issue a "
- ":exc:`RuntimeWarning`, and will return the part of it which is inside the "
- "buffer provided it has not been truncated before the start of its associated"
- " data."
- msgstr ""
- # a324dc99a25a4559b7da26b6d8201c70
- #: ../../library/socket.rst:942
- msgid ""
- "On systems which support the :const:`SCM_RIGHTS` mechanism, the following "
- "function will receive up to *maxfds* file descriptors, returning the message"
- " data and a list containing the descriptors (while ignoring unexpected "
- "conditions such as unrelated control messages being received). See also "
- ":meth:`sendmsg`. ::"
- msgstr ""
- # 79276ab1c2d546b0aa1221553610b4c9
- #: ../../library/socket.rst:966
- msgid ""
- "Receive normal data and ancillary data from the socket, behaving as "
- ":meth:`recvmsg` would, but scatter the non-ancillary data into a series of "
- "buffers instead of returning a new bytes object. The *buffers* argument "
- "must be an iterable of objects that export writable buffers (e.g. "
- ":class:`bytearray` objects); these will be filled with successive chunks of "
- "the non-ancillary data until it has all been written or there are no more "
- "buffers. The operating system may set a limit (:func:`~os.sysconf` value "
- "``SC_IOV_MAX``) on the number of buffers that can be used. The *ancbufsize*"
- " and *flags* arguments have the same meaning as for :meth:`recvmsg`."
- msgstr ""
- # e4c9a4057493418192eea01d2b0e2d27
- #: ../../library/socket.rst:977
- msgid ""
- "The return value is a 4-tuple: ``(nbytes, ancdata, msg_flags, address)``, "
- "where *nbytes* is the total number of bytes of non-ancillary data written "
- "into the buffers, and *ancdata*, *msg_flags* and *address* are the same as "
- "for :meth:`recvmsg`."
- msgstr ""
- # 33927a201c834cf28ad364a61ed77688
- #: ../../library/socket.rst:982
- msgid "Example::"
- msgstr "例::"
- # d2f9afbd5da8450ba447c4d7e8b89d25
- #: ../../library/socket.rst:1003
- msgid ""
- "Receive data from the socket, writing it into *buffer* instead of creating a"
- " new bytestring. The return value is a pair ``(nbytes, address)`` where "
- "*nbytes* is the number of bytes received and *address* is the address of the"
- " socket sending the data. See the Unix manual page :manpage:`recv(2)` for "
- "the meaning of the optional argument *flags*; it defaults to zero. (The "
- "format of *address* depends on the address family --- see above.)"
- msgstr "ソケットからデータを受信し、そのデータを新しいバイト文字列として返す代わりに *buffer* に書きます。戻り値は ``(nbytes, address)`` のペアで、 *nbytes* は受信したデータのバイト数を、 *address* はデータを送信したソケットのアドレスです。オプション引数 *flags* (デフォルト:0) の意味については、 Unix マニュアルページ :manpage:`recv(2)` を参照してください。(*address* のフォーマットは前述のとおりアドレスファミリーに依存します。)"
- # 9ca864b9a4674e5e8964b3f93d948a24
- #: ../../library/socket.rst:1013
- msgid ""
- "Receive up to *nbytes* bytes from the socket, storing the data into a buffer"
- " rather than creating a new bytestring. If *nbytes* is not specified (or "
- "0), receive up to the size available in the given buffer. Returns the "
- "number of bytes received. See the Unix manual page :manpage:`recv(2)` for "
- "the meaning of the optional argument *flags*; it defaults to zero."
- msgstr "*nbytes* バイトまでのデータをソケットから受信して、そのデータを新しいバイト文字列にするのではなく *buffer* に保存します。 *nbytes* が指定されない(あるいは0が指定された)場合、 *buffer* の利用可能なサイズまで受信します。受信したバイト数を返り値として返します。オプション引数 *flags* (デフォルト:0) の意味については、 Unix マニュアルページ :manpage:`recv(2)` を参照してください。"
- # d3ed2dbaf81c42a79db2fa782c446da8
- #: ../../library/socket.rst:1022
- msgid ""
- "Send data to the socket. The socket must be connected to a remote socket. "
- "The optional *flags* argument has the same meaning as for :meth:`recv` "
- "above. Returns the number of bytes sent. Applications are responsible for "
- "checking that all data has been sent; if only some of the data was "
- "transmitted, the application needs to attempt delivery of the remaining "
- "data. For further information on this topic, consult the :ref:`socket-"
- "howto`."
- msgstr ""
- # f9c12d1cd4fc4149b84d555b22a7050c
- #: ../../library/socket.rst:1032
- msgid ""
- "Send data to the socket. The socket must be connected to a remote socket. "
- "The optional *flags* argument has the same meaning as for :meth:`recv` "
- "above. Unlike :meth:`send`, this method continues to send data from *bytes* "
- "until either all data has been sent or an error occurs. ``None`` is "
- "returned on success. On error, an exception is raised, and there is no way "
- "to determine how much data, if any, was successfully sent."
- msgstr "ソケットにデータを送信します。ソケットはリモートソケットに接続済みでなければなりません。オプション引数 *flags* の意味は、上記 :meth:`recv` と同じです。 :meth:`send` と異なり、このメソッドは *bytes* の全データを送信するか、エラーが発生するまで処理を継続します。正常終了の場合は ``None`` を返し、エラー発生時には例外が発生します。エラー発生時、送信されたバイト数を調べる事はできません。"
- # 467bf26a65a34f7aad2870bdd916c8eb
- #: ../../library/socket.rst:1043
- msgid ""
- "Send data to the socket. The socket should not be connected to a remote "
- "socket, since the destination socket is specified by *address*. The "
- "optional *flags* argument has the same meaning as for :meth:`recv` above. "
- "Return the number of bytes sent. (The format of *address* depends on the "
- "address family --- see above.)"
- msgstr "ソケットにデータを送信します。このメソッドでは接続先を *address* で指定するので、接続済みではいけません。オプション引数 *flags* の意味は、上記 :meth:`recv` と同じです。戻り値として、送信したバイト数を返します。 *address* のフォーマットはアドレスファミリによって異なります(前述)。"
- # 5c2bcc9768e8450bbba4e373c8be834f
- #: ../../library/socket.rst:1052
- msgid ""
- "Send normal and ancillary data to the socket, gathering the non-ancillary "
- "data from a series of buffers and concatenating it into a single message. "
- "The *buffers* argument specifies the non-ancillary data as an iterable of "
- "buffer-compatible objects (e.g. :class:`bytes` objects); the operating "
- "system may set a limit (:func:`~os.sysconf` value ``SC_IOV_MAX``) on the "
- "number of buffers that can be used. The *ancdata* argument specifies the "
- "ancillary data (control messages) as an iterable of zero or more tuples "
- "``(cmsg_level, cmsg_type, cmsg_data)``, where *cmsg_level* and *cmsg_type* "
- "are integers specifying the protocol level and protocol-specific type "
- "respectively, and *cmsg_data* is a buffer-compatible object holding the "
- "associated data. Note that some systems (in particular, systems without "
- ":func:`CMSG_SPACE`) might support sending only one control message per call."
- " The *flags* argument defaults to 0 and has the same meaning as for "
- ":meth:`send`. If *address* is supplied and not ``None``, it sets a "
- "destination address for the message. The return value is the number of "
- "bytes of non-ancillary data sent."
- msgstr ""
- # e1851ea974b64c39b9135769441f97d2
- #: ../../library/socket.rst:1071
- msgid ""
- "The following function sends the list of file descriptors *fds* over an "
- ":const:`AF_UNIX` socket, on systems which support the :const:`SCM_RIGHTS` "
- "mechanism. See also :meth:`recvmsg`. ::"
- msgstr ""
- # d2c42579ecbc41898c3be9ace4ce04c1
- #: ../../library/socket.rst:1087
- msgid ""
- "Set blocking or non-blocking mode of the socket: if *flag* is false, the "
- "socket is set to non-blocking, else to blocking mode."
- msgstr ""
- # 575863e0b86f4a3cbdcec78652ffb45d
- #: ../../library/socket.rst:1090
- msgid ""
- "This method is a shorthand for certain :meth:`~socket.settimeout` calls:"
- msgstr ""
- # 5db3bddc0c0a4dab8e78f620c999084b
- #: ../../library/socket.rst:1092
- msgid "``sock.setblocking(True)`` is equivalent to ``sock.settimeout(None)``"
- msgstr ""
- # cd9df25ff0274674b65422d1f3384dc3
- #: ../../library/socket.rst:1094
- msgid "``sock.setblocking(False)`` is equivalent to ``sock.settimeout(0.0)``"
- msgstr ""
- # 5ef926d9c4784146aa229faf9c0486d8
- #: ../../library/socket.rst:1099
- msgid ""
- "Set a timeout on blocking socket operations. The *value* argument can be a "
- "nonnegative floating point number expressing seconds, or ``None``. If a non-"
- "zero value is given, subsequent socket operations will raise a "
- ":exc:`timeout` exception if the timeout period *value* has elapsed before "
- "the operation has completed. If zero is given, the socket is put in non-"
- "blocking mode. If ``None`` is given, the socket is put in blocking mode."
- msgstr ""
- # b520f65855da45aeb2b185429172fa66
- #: ../../library/socket.rst:1106
- msgid ""
- "For further information, please consult the :ref:`notes on socket timeouts "
- "<socket-timeouts>`."
- msgstr ""
- # fd824c4ca65d49bba88f60decd8e8a8b
- #: ../../library/socket.rst:1113
- msgid ""
- "Set the value of the given socket option (see the Unix manual page "
- ":manpage:`setsockopt(2)`). The needed symbolic constants are defined in the"
- " :mod:`socket` module (:const:`SO_\\*` etc.). The value can be an integer "
- "or a bytes object representing a buffer. In the latter case it is up to the"
- " caller to ensure that the bytestring contains the proper bits (see the "
- "optional built-in module :mod:`struct` for a way to encode C structures as "
- "bytestrings)."
- msgstr "ソケットのオプションを設定します(Unixのマニュアルページ :manpage:`setsockopt(2)` を参照)。 :const:`SO_\\*` 等のシンボルは、このモジュールで定義しています。 ``value`` には、整数またはバイト列オブジェクトをバッファとして指定する事ができます。文字列を指定する場合、文字列には適切なビットを設定するようにします (:mod:`struct` モジュールを利用すれば、Cの構造体をバイト文字列にエンコードする事ができます)。"
- # 0937f0d6a4754f0f97db2291342d9ebc
- #: ../../library/socket.rst:1123
- msgid ""
- "Shut down one or both halves of the connection. If *how* is "
- ":const:`SHUT_RD`, further receives are disallowed. If *how* is "
- ":const:`SHUT_WR`, further sends are disallowed. If *how* is "
- ":const:`SHUT_RDWR`, further sends and receives are disallowed."
- msgstr "接続の片方向、または両方向を切断します。 *how* が :const:`SHUT_RD` の場合、以降は受信を行えません。 *how* が :const:`SHUT_WR` の場合、以降は送信を行えません。 *how* が ``SHUT_RDWR`` の場合、以降は送受信を行えません。"
- # 39dd6776bcc544ec945df03038704fc4
- #: ../../library/socket.rst:1131
- msgid ""
- "Duplicate a socket and prepare it for sharing with a target process. The "
- "target process must be provided with *process_id*. The resulting bytes "
- "object can then be passed to the target process using some form of "
- "interprocess communication and the socket can be recreated there using "
- ":func:`fromshare`. Once this method has been called, it is safe to close the"
- " socket since the operating system has already duplicated it for the target "
- "process."
- msgstr ""
- # 29f21a711c074212afd8592f8379d7e0
- #: ../../library/socket.rst:1143
- msgid ""
- "Note that there are no methods :meth:`read` or :meth:`write`; use "
- ":meth:`~socket.recv` and :meth:`~socket.send` without *flags* argument "
- "instead."
- msgstr ":meth:`read` メソッドと :meth:`write` メソッドは存在しませんので注意してください。代わりに *flags* を省略した :meth:`~socket.recv` と :meth:`~socket.send` を使うことができます。"
- # 32f731f8661046c0bcd56a8eaaf09c8c
- #: ../../library/socket.rst:1146
- msgid ""
- "Socket objects also have these (read-only) attributes that correspond to the"
- " values given to the :class:`socket` constructor."
- msgstr "ソケットオブジェクトには以下の :class:`socket` コンストラクタに渡された値に対応した(読み出し専用)属性があります。"
- # d55d380ed12543c9b6e89d30931514cd
- #: ../../library/socket.rst:1152
- msgid "The socket family."
- msgstr "ソケットファミリー。"
- # 3f4fd6cd9af5466f9c57822577d2449f
- #: ../../library/socket.rst:1157
- msgid "The socket type."
- msgstr "ソケットタイプ。"
- # 89c9509ebd5d4c91915d57b3b80ade6f
- #: ../../library/socket.rst:1162
- msgid "The socket protocol."
- msgstr "ソケットプロトコル。"
- # 52a1b5c265034739b2abbeb209347740
- #: ../../library/socket.rst:1169
- msgid "Notes on socket timeouts"
- msgstr ""
- # d03f86ba105946fd9504c7ecba78216f
- #: ../../library/socket.rst:1171
- msgid ""
- "A socket object can be in one of three modes: blocking, non-blocking, or "
- "timeout. Sockets are by default always created in blocking mode, but this "
- "can be changed by calling :func:`setdefaulttimeout`."
- msgstr ""
- # 695d3c8abdef4543af329b643953866d
- #: ../../library/socket.rst:1175
- msgid ""
- "In *blocking mode*, operations block until complete or the system returns an"
- " error (such as connection timed out)."
- msgstr ""
- # 36117dce2eba4f0193eae2ea1ed95a25
- #: ../../library/socket.rst:1178
- msgid ""
- "In *non-blocking mode*, operations fail (with an error that is unfortunately"
- " system-dependent) if they cannot be completed immediately: functions from "
- "the :mod:`select` can be used to know when and whether a socket is available"
- " for reading or writing."
- msgstr ""
- # 170c44c71ac84faf872b1c8b0e0f4049
- #: ../../library/socket.rst:1183
- msgid ""
- "In *timeout mode*, operations fail if they cannot be completed within the "
- "timeout specified for the socket (they raise a :exc:`timeout` exception) or "
- "if the system returns an error."
- msgstr ""
- # ca0939fe859544f5ac8298982a9ba395
- #: ../../library/socket.rst:1188
- msgid ""
- "At the operating system level, sockets in *timeout mode* are internally set "
- "in non-blocking mode. Also, the blocking and timeout modes are shared "
- "between file descriptors and socket objects that refer to the same network "
- "endpoint. This implementation detail can have visible consequences if e.g. "
- "you decide to use the :meth:`~socket.fileno()` of a socket."
- msgstr ""
- # 00f3a4c1fb434937bcea241ccba1541f
- #: ../../library/socket.rst:1195
- msgid "Timeouts and the ``connect`` method"
- msgstr ""
- # aef299ca42974a088811e47be15840e5
- #: ../../library/socket.rst:1197
- msgid ""
- "The :meth:`~socket.connect` operation is also subject to the timeout "
- "setting, and in general it is recommended to call :meth:`~socket.settimeout`"
- " before calling :meth:`~socket.connect` or pass a timeout parameter to "
- ":meth:`create_connection`. However, the system network stack may also "
- "return a connection timeout error of its own regardless of any Python socket"
- " timeout setting."
- msgstr ""
- # dc8099e289d34b8199e62c3cefef2520
- #: ../../library/socket.rst:1205
- msgid "Timeouts and the ``accept`` method"
- msgstr ""
- # dcc43c90abea426eb8374aefae6988f7
- #: ../../library/socket.rst:1207
- msgid ""
- "If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by the "
- ":meth:`~socket.accept` method inherit that timeout. Otherwise, the "
- "behaviour depends on settings of the listening socket:"
- msgstr ""
- # 807d8dda3e4e4b788c2c3e88fa0a98b3
- #: ../../library/socket.rst:1211
- msgid ""
- "if the listening socket is in *blocking mode* or in *timeout mode*, the "
- "socket returned by :meth:`~socket.accept` is in *blocking mode*;"
- msgstr ""
- # d3db6b8d6c7841e4b10d38c404c869f5
- #: ../../library/socket.rst:1214
- msgid ""
- "if the listening socket is in *non-blocking mode*, whether the socket "
- "returned by :meth:`~socket.accept` is in blocking or non-blocking mode is "
- "operating system-dependent. If you want to ensure cross-platform behaviour,"
- " it is recommended you manually override this setting."
- msgstr ""
- # 84aabc75cc6a4cab8c61a386e3dcae35
- #: ../../library/socket.rst:1223
- msgid "Example"
- msgstr "例"
- # 335e390652a7407ca39d296b6a594d16
- #: ../../library/socket.rst:1225
- msgid ""
- "Here are four minimal example programs using the TCP/IP protocol: a server "
- "that echoes all data that it receives back (servicing only one client), and "
- "a client using it. Note that a server must perform the sequence "
- ":func:`.socket`, :meth:`~socket.bind`, :meth:`~socket.listen`, "
- ":meth:`~socket.accept` (possibly repeating the :meth:`~socket.accept` to "
- "service more than one client), while a client only needs the sequence "
- ":func:`.socket`, :meth:`~socket.connect`. Also note that the server does "
- "not :meth:`~socket.sendall`/:meth:`~socket.recv` on the socket it is "
- "listening on but on the new socket returned by :meth:`~socket.accept`."
- msgstr ""
- # 2edf75dcf9d244af88fe46207f802bd9
- #: ../../library/socket.rst:1235
- msgid "The first two examples support IPv4 only. ::"
- msgstr "次のクライアントとサーバは、IPv4のみをサポートしています。 ::"
- # b66148a82efb4aeca21c6527f1390399
- #: ../../library/socket.rst:1267
- msgid ""
- "The next two examples are identical to the above two, but support both IPv4 "
- "and IPv6. The server side will listen to the first address family available "
- "(it should listen to both instead). On most of IPv6-ready systems, IPv6 will"
- " take precedence and the server may not accept IPv4 traffic. The client side"
- " will try to connect to the all addresses returned as a result of the name "
- "resolution, and sends traffic to the first one connected successfully. ::"
- msgstr "次のサンプルは上記のサンプルとほとんど同じですが、IPv4とIPv6の両方をサポートしています。サーバでは、IPv4/v6の両方ではなく、利用可能な最初のアドレスファミリだけをlistenしています。ほとんどのIPv6対応システムではIPv6が先に現れるため、サーバはIPv4には応答しません。クライアントでは名前解決の結果として取得したアドレスに順次接続を試み、最初に接続に成功したソケットにデータを送信しています。 ::"
- # b0cdfc0b7c40457f95af07b394bcb4d8
- #: ../../library/socket.rst:1340
- msgid ""
- "The next example shows how to write a very simple network sniffer with raw "
- "sockets on Windows. The example requires administrator privileges to modify "
- "the interface::"
- msgstr "次の例は、Windowsで raw socket を利用して非常にシンプルなネットワークスニファーを書きます。このサンプルを実行するには、インタフェースを操作するための管理者権限が必要です::"
- # c2b3e045c6464ebfb4f103ef699952b8
- #: ../../library/socket.rst:1365
- msgid ""
- "The last example shows how to use the socket interface to communicate to a "
- "CAN network. This example might require special priviledge::"
- msgstr ""
- # fa76f50bc11e422593226d00627f27ce
- #: ../../library/socket.rst:1406
- msgid ""
- "Running an example several times with too small delay between executions, "
- "could lead to this error::"
- msgstr ""
- # fe56c8172afc41a0817bc99267597ad9
- #: ../../library/socket.rst:1411
- msgid ""
- "This is because the previous execution has left the socket in a "
- "``TIME_WAIT`` state, and can't be immediately reused."
- msgstr ""
- # a2d9c7600a244d8aaffafc7c7bd5217e
- #: ../../library/socket.rst:1414
- msgid ""
- "There is a :mod:`socket` flag to set, in order to prevent this, "
- ":data:`socket.SO_REUSEADDR`::"
- msgstr ""
- # 933f558c6ff641b9a1f38813d975b18f
- #: ../../library/socket.rst:1421
- msgid ""
- "the :data:`SO_REUSEADDR` flag tells the kernel to reuse a local socket in "
- "``TIME_WAIT`` state, without waiting for its natural timeout to expire."
- msgstr ""
- # 47e84bd43cfb4f46b01e004d084eb905
- #: ../../library/socket.rst:1427
- msgid ""
- "For an introduction to socket programming (in C), see the following papers:"
- msgstr ""
- # beda6c0761884fc28d70959a34badd00
- #: ../../library/socket.rst:1429
- msgid ""
- "*An Introductory 4.3BSD Interprocess Communication Tutorial*, by Stuart "
- "Sechrest"
- msgstr ""
- # fe182eeff6b14fc5b11c6727cefb3820
- #: ../../library/socket.rst:1431
- msgid ""
- "*An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. "
- "Leffler et al,"
- msgstr ""
- # 31b716f717d348acac29f666207a0bdb
- #: ../../library/socket.rst:1434
- msgid ""
- "both in the UNIX Programmer's Manual, Supplementary Documents 1 (sections "
- "PS1:7 and PS1:8). The platform-specific reference material for the various "
- "socket-related system calls are also a valuable source of information on the"
- " details of socket semantics. For Unix, refer to the manual pages; for "
- "Windows, see the WinSock (or Winsock 2) specification. For IPv6-ready APIs,"
- " readers may want to refer to :rfc:`3493` titled Basic Socket Interface "
- "Extensions for IPv6."
- msgstr ""
- # 14e893c234044918a605d0f03c4170c9
- #: ../../library/socket.rst:17
- msgid "socket"
- msgstr ""
- # 461f58032f504769b6ed691559e20b65
- #: ../../library/socket.rst:855
- msgid "I/O control"
- msgstr "I/O control"
- # 461f58032f504769b6ed691559e20b65
- #: ../../library/socket.rst:855
- msgid "buffering"
- msgstr "buffering"
- # 72aef4ef3af14c299956028aa524fb95
- #: ../../library/socket.rst:1111
- msgid "struct"
- msgstr ""