@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.13\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2025-04-18 14:18 +0000\n "
14+ "POT-Creation-Date : 2025-04-25 14:19 +0000\n "
1515"PO-Revision-Date : 2021-06-28 01:06+0000\n "
1616"Last-Translator : Stan Ulbrych, 2025\n "
1717"Language-Team : Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n "
@@ -110,22 +110,38 @@ msgid ""
110110"a :meth:`~io.IOBase.fileno` method are accepted as well). The values used "
111111"for *cmd* are operating system dependent, and are available as constants in "
112112"the :mod:`fcntl` module, using the same names as used in the relevant C "
113- "header files. The argument *arg* can either be an integer value, or a :class:"
114- "`bytes` object. With an integer value, the return value of this function is "
115- "the integer return value of the C :c:func:`fcntl` call. When the argument "
116- "is bytes it represents a binary structure, e.g. created by :func:`struct."
117- "pack`. The binary data is copied to a buffer whose address is passed to the "
118- "C :c:func:`fcntl` call. The return value after a successful call is the "
119- "contents of the buffer, converted to a :class:`bytes` object. The length of "
120- "the returned object will be the same as the length of the *arg* argument. "
121- "This is limited to 1024 bytes. If the information returned in the buffer by "
122- "the operating system is larger than 1024 bytes, this is most likely to "
123- "result in a segmentation violation or a more subtle data corruption."
113+ "header files. The argument *arg* can either be an integer value, a :class:"
114+ "`bytes` object, or a string. The type and size of *arg* must match the type "
115+ "and size of the argument of the operation as specified in the relevant C "
116+ "documentation."
117+ msgstr ""
118+
119+ msgid ""
120+ "When *arg* is an integer, the function returns the integer return value of "
121+ "the C :c:func:`fcntl` call."
122+ msgstr ""
123+
124+ msgid ""
125+ "When the argument is bytes, it represents a binary structure, for example, "
126+ "created by :func:`struct.pack`. A string value is encoded to binary using "
127+ "the UTF-8 encoding. The binary data is copied to a buffer whose address is "
128+ "passed to the C :c:func:`fcntl` call. The return value after a successful "
129+ "call is the contents of the buffer, converted to a :class:`bytes` object. "
130+ "The length of the returned object will be the same as the length of the "
131+ "*arg* argument. This is limited to 1024 bytes."
124132msgstr ""
125133
126134msgid "If the :c:func:`fcntl` call fails, an :exc:`OSError` is raised."
127135msgstr ""
128136
137+ msgid ""
138+ "If the type or the size of *arg* does not match the type or size of the "
139+ "argument of the operation (for example, if an integer is passed when a "
140+ "pointer is expected, or the information returned in the buffer by the "
141+ "operating system is larger than 1024 bytes), this is most likely to result "
142+ "in a segmentation violation or a more subtle data corruption."
143+ msgstr ""
144+
129145msgid ""
130146"Raises an :ref:`auditing event <auditing>` ``fcntl.fcntl`` with arguments "
131147"``fd``, ``cmd``, ``arg``."
@@ -137,47 +153,45 @@ msgid ""
137153msgstr ""
138154
139155msgid ""
140- "The *request* parameter is limited to values that can fit in 32-bits. "
141- "Additional constants of interest for use as the *request* argument can be "
142- "found in the :mod:`termios` module, under the same names as used in the "
143- "relevant C header files."
156+ "The *request* parameter is limited to values that can fit in 32-bits or 64- "
157+ "bits, depending on the platform. Additional constants of interest for use as "
158+ "the *request* argument can be found in the :mod:`termios` module, under the "
159+ "same names as used in the relevant C header files."
144160msgstr ""
145161
146162msgid ""
147- "The parameter *arg* can be one of an integer, an object supporting the read- "
148- "only buffer interface (like :class:`bytes`) or an object supporting the read- "
149- "write buffer interface (like :class:`bytearray`) ."
163+ "The parameter *arg* can be an integer, a :term:`bytes-like object`, or a "
164+ "string. The type and size of *arg* must match the type and size of the "
165+ "argument of the operation as specified in the relevant C documentation ."
150166msgstr ""
151167
152168msgid ""
153- "In all but the last case, behaviour is as for the :func:`~fcntl.fcntl` "
154- "function."
169+ "If *arg* does not support the read-write buffer interface or the "
170+ "*mutate_flag* is false, behavior is as for the :func:`~fcntl.fcntl` function."
155171msgstr ""
156172
157173msgid ""
158- "If a mutable buffer is passed, then the behaviour is determined by the value "
159- "of the *mutate_flag* parameter."
174+ "If *arg* supports the read-write buffer interface (like :class:`bytearray`) "
175+ "and *mutate_flag* is true (the default), then the buffer is (in effect) "
176+ "passed to the underlying :c:func:`!ioctl` system call, the latter's return "
177+ "code is passed back to the calling Python, and the buffer's new contents "
178+ "reflect the action of the :c:func:`ioctl`. This is a slight simplification, "
179+ "because if the supplied buffer is less than 1024 bytes long it is first "
180+ "copied into a static buffer 1024 bytes long which is then passed to :func:"
181+ "`ioctl` and copied back into the supplied buffer."
160182msgstr ""
161183
162184msgid ""
163- "If it is false, the buffer's mutability is ignored and behaviour is as for a "
164- "read-only buffer, except that the 1024 byte limit mentioned above is avoided "
165- "-- so long as the buffer you pass is at least as long as what the operating "
166- "system wants to put there, things should work."
167- msgstr ""
168-
169- msgid ""
170- "If *mutate_flag* is true (the default), then the buffer is (in effect) "
171- "passed to the underlying :func:`ioctl` system call, the latter's return code "
172- "is passed back to the calling Python, and the buffer's new contents reflect "
173- "the action of the :func:`ioctl`. This is a slight simplification, because "
174- "if the supplied buffer is less than 1024 bytes long it is first copied into "
175- "a static buffer 1024 bytes long which is then passed to :func:`ioctl` and "
176- "copied back into the supplied buffer."
185+ "If the :c:func:`ioctl` call fails, an :exc:`OSError` exception is raised."
177186msgstr ""
178187
179188msgid ""
180- "If the :c:func:`ioctl` call fails, an :exc:`OSError` exception is raised."
189+ "If the type or size of *arg* does not match the type or size of the "
190+ "operation's argument (for example, if an integer is passed when a pointer is "
191+ "expected, or the information returned in the buffer by the operating system "
192+ "is larger than 1024 bytes, or the size of the mutable bytes-like object is "
193+ "too small), this is most likely to result in a segmentation violation or a "
194+ "more subtle data corruption."
181195msgstr ""
182196
183197msgid "An example::"
0 commit comments