XAsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget2/translations/zh_CN/userspace-api/media/gen-errorsmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget2/translations/zh_TW/userspace-api/media/gen-errorsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget2/translations/it_IT/userspace-api/media/gen-errorsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget2/translations/ja_JP/userspace-api/media/gen-errorsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget2/translations/ko_KR/userspace-api/media/gen-errorsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget2/translations/sp_SP/userspace-api/media/gen-errorsmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-laterh]h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhL/var/lib/git/docbuild/linux/Documentation/userspace-api/media/gen-errors.rsthKubhtarget)}(h.. _gen_errors:h]h}(h]h ]h"]h$]h&]refid gen-errorsuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hGeneric Error Codesh]hGeneric Error Codes}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(h.. _gen-errors:h]h}(h]h ]h"]h$]h&]hid1uh1hhK hhhhhhubhtabular_col_spec)}(hhh]h}(h]hah ]h"] gen-errorsah$]h&]spec|p{2.5cm}|p{15.0cm}|uh1hhhhK hhhhexpect_referenced_by_name}hhsexpect_referenced_by_id}hhsubhtable)}(hhh](h)}(hGeneric error codesh]hGeneric error codes}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubhtgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubj )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h paragraph)}(h ``EAGAIN`` (aka ``EWOULDBLOCK``)h](hliteral)}(h ``EAGAIN``h]hEAGAIN}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1j7hj3ubh (aka }(hj3hhhNhNubj8)}(h``EWOULDBLOCK``h]h EWOULDBLOCK}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hj3ubh)}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1j1hhhKhj.ubah}(h]h ]h"]h$]h&]uh1j,hj)ubj-)}(hhh]j2)}(hX3The ioctl can't be handled because the device is in state where it can't perform it. This could happen for example in case where device is sleeping and ioctl is performed to query statistics. It is also returned when the ioctl would need to wait for an event, but the device was opened in non-blocking mode.h]hX7The ioctl can’t be handled because the device is in state where it can’t perform it. This could happen for example in case where device is sleeping and ioctl is performed to query statistics. It is also returned when the ioctl would need to wait for an event, but the device was opened in non-blocking mode.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhKhjiubah}(h]h ]h"]h$]h&]uh1j,hj)ubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``EBADF``h]j8)}(hjh]hEBADF}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&]uh1j1hhhKhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hhh]j2)}(h#The file descriptor is not a valid.h]h#The file descriptor is not a valid.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhKhjubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``EBUSY``h]j8)}(hjh]hEBUSY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&]uh1j1hhhK hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hhh]j2)}(hXThe ioctl can't be handled because the device is busy. This is typically return while device is streaming, and an ioctl tried to change something that would affect the stream, or would require the usage of a hardware resource that was already allocated. The ioctl must not be retried without performing another action to fix the problem first (typically: stop the stream before retrying).h]hXThe ioctl can’t be handled because the device is busy. This is typically return while device is streaming, and an ioctl tried to change something that would affect the stream, or would require the usage of a hardware resource that was already allocated. The ioctl must not be retried without performing another action to fix the problem first (typically: stop the stream before retrying).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhK"hjubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``EFAULT``h]j8)}(hjh]hEFAULT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hj ubah}(h]h ]h"]h$]h&]uh1j1hhhK)hj ubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hhh]j2)}(hjThere was a failure while copying data from/to userspace, probably caused by an invalid pointer reference.h]hjThere was a failure while copying data from/to userspace, probably caused by an invalid pointer reference.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhK+hj)ubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``EINVAL``h]j8)}(hjNh]hEINVAL}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hjLubah}(h]h ]h"]h$]h&]uh1j1hhhK.hjIubah}(h]h ]h"]h$]h&]uh1j,hjFubj-)}(hhh]j2)}(hOne or more of the ioctl parameters are invalid or out of the allowed range. This is a widely used error code. See the individual ioctl requests for specific causes.h]hOne or more of the ioctl parameters are invalid or out of the allowed range. This is a widely used error code. See the individual ioctl requests for specific causes.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhK0hjiubah}(h]h ]h"]h$]h&]uh1j,hjFubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``ENODEV``h]j8)}(hjh]hENODEV}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&]uh1j1hhhK4hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hhh]j2)}(h Device not found or was removed.h]h Device not found or was removed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhK6hjubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``ENOMEM``h]j8)}(hjh]hENOMEM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&]uh1j1hhhK8hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hhh]j2)}(h:There's not enough memory to handle the desired operation.h]hhj)ubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``ENOSPC``h]j8)}(hjNh]hENOSPC}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hjLubah}(h]h ]h"]h$]h&]uh1j1hhhK@hjIubah}(h]h ]h"]h$]h&]uh1j,hjFubj-)}(hhh]j2)}(hOn USB devices, the stream ioctl's can return this error, meaning that this request would overcommit the usb bandwidth reserved for periodic transfers (up to 80% of the USB bandwidth).h]hOn USB devices, the stream ioctl’s can return this error, meaning that this request would overcommit the usb bandwidth reserved for periodic transfers (up to 80% of the USB bandwidth).}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhKBhjiubah}(h]h ]h"]h$]h&]uh1j,hjFubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``EPERM``h]j8)}(hjh]hEPERM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&]uh1j1hhhKFhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hhh]j2)}(h|Permission denied. Can be returned if the device needs write permission, or some special capabilities is needed (e. g. root)h]h|Permission denied. Can be returned if the device needs write permission, or some special capabilities is needed (e. g. root)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhKHhjubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h``EIO``h]j8)}(hjh]hEIO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hjubah}(h]h ]h"]h$]h&]uh1j1hhhKKhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hhh]j2)}(hI/O error. Typically used when there are problems communicating with a hardware device. This could indicate broken or flaky hardware. It's a 'Something is wrong, I give up!' type of error.h]hI/O error. Typically used when there are problems communicating with a hardware device. This could indicate broken or flaky hardware. It’s a ‘Something is wrong, I give up!’ type of error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhKMhjubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]uh1j'hj$ubj()}(hhh](j-)}(hhh]j2)}(h ``ENXIO``h]j8)}(hjh]hENXIO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j7hj ubah}(h]h ]h"]h$]h&]uh1j1hhhKQhj ubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hhh]j2)}(h;No device corresponding to this device special file exists.h]h;No device corresponding to this device special file exists.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhKShj)ubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]uh1j'hj$ubeh}(h]h ]h"]h$]h&]uh1j"hj ubeh}(h]h ]h"]h$]h&]colsKuh1jhhubeh}(h]id2ah ]h"]h$]h&]uh1hhhhhhNhNubhnote)}(hXG#. This list is not exhaustive; ioctls may return other error codes. Since errors may have side effects such as a driver reset, applications should abort on unexpected errors, or otherwise assume that the device is in a bad state. #. Request-specific error codes are listed in the individual requests descriptions.h]henumerated_list)}(hhh](h list_item)}(hThis list is not exhaustive; ioctls may return other error codes. Since errors may have side effects such as a driver reset, applications should abort on unexpected errors, or otherwise assume that the device is in a bad state. h]j2)}(hThis list is not exhaustive; ioctls may return other error codes. Since errors may have side effects such as a driver reset, applications should abort on unexpected errors, or otherwise assume that the device is in a bad state.h]hThis list is not exhaustive; ioctls may return other error codes. Since errors may have side effects such as a driver reset, applications should abort on unexpected errors, or otherwise assume that the device is in a bad state.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhKXhjgubah}(h]h ]h"]h$]h&]uh1jehjbubjf)}(hPRequest-specific error codes are listed in the individual requests descriptions.h]j2)}(hPRequest-specific error codes are listed in the individual requests descriptions.h]hPRequest-specific error codes are listed in the individual requests descriptions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hhhK]hjubah}(h]h ]h"]h$]h&]uh1jehjbubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1j`hj\ubah}(h]h ]h"]h$]h&]uh1jZhhhhhNhNubeh}(h](generic-error-codesheh ]h"](generic error codes gen_errorseh$]h&]uh1hhhhhhhhKh}jhsh}hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj,footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}(h]hah]haunameids}(jhjjhhu nametypes}(jjhuh}(hhjhhhjUhu footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jKsRparse_messages]transform_messages](hsystem_message)}(hhh]j2)}(hhh]h0Hyperlink target "gen-errors" is not referenced.}hj@sbah}(h]h ]h"]h$]h&]uh1j1hj=ubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1j;ubj<)}(hhh]j2)}(hhh]h)Hyperlink target "id1" is not referenced.}hj[sbah}(h]h ]h"]h$]h&]uh1j1hjXubah}(h]h ]h"]h$]h&]levelKtypejUsourcehlineK uh1j;ube transformerN include_log] decorationNhhub.