KBsphinx.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]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget2/translations/pt_BR/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&]hԌid1uh1hhK 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}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubhtgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hjubj!)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hjubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h paragraph)}(h ``EAGAIN`` (aka ``EWOULDBLOCK``)h](hliteral)}(h ``EAGAIN``h]hEAGAIN}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhjGubh (aka }(hjGhhhNhNubjL)}(h``EWOULDBLOCK``h]h EWOULDBLOCK}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jKhjGubh)}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1jEhhhKhjBubah}(h]h ]h"]h$]h&]uh1j@hj=ubjA)}(hhh]jF)}(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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhhhKhj}ubah}(h]h ]h"]h$]h&]uh1j@hj=ubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``EBADF``h]jL)}(hjh]hEBADF}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhjubah}(h]h ]h"]h$]h&]uh1jEhhhKhjubah}(h]h ]h"]h$]h&]uh1j@hjubjA)}(hhh]jF)}(h#The file descriptor is not a valid.h]h#The file descriptor is not a valid.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhhhKhjubah}(h]h ]h"]h$]h&]uh1j@hjubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``EBUSY``h]jL)}(hjh]hEBUSY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhjubah}(h]h ]h"]h$]h&]uh1jEhhhK hjubah}(h]h ]h"]h$]h&]uh1j@hjubjA)}(hhh]jF)}(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&]uh1jEhhhK"hjubah}(h]h ]h"]h$]h&]uh1j@hjubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``EFAULT``h]jL)}(hj"h]hEFAULT}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jKhj ubah}(h]h ]h"]h$]h&]uh1jEhhhK)hjubah}(h]h ]h"]h$]h&]uh1j@hjubjA)}(hhh]jF)}(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&]uh1jEhhhK+hj=ubah}(h]h ]h"]h$]h&]uh1j@hjubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``EINVAL``h]jL)}(hjbh]hEINVAL}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhj`ubah}(h]h ]h"]h$]h&]uh1jEhhhK.hj]ubah}(h]h ]h"]h$]h&]uh1j@hjZubjA)}(hhh]jF)}(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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhhhK0hj}ubah}(h]h ]h"]h$]h&]uh1j@hjZubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``ENODEV``h]jL)}(hjh]hENODEV}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhjubah}(h]h ]h"]h$]h&]uh1jEhhhK4hjubah}(h]h ]h"]h$]h&]uh1j@hjubjA)}(hhh]jF)}(h Device not found or was removed.h]h Device not found or was removed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhhhK6hjubah}(h]h ]h"]h$]h&]uh1j@hjubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``ENOMEM``h]jL)}(hjh]hENOMEM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhjubah}(h]h ]h"]h$]h&]uh1jEhhhK8hjubah}(h]h ]h"]h$]h&]uh1j@hjubjA)}(hhh]jF)}(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;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``ENOSPC``h]jL)}(hjbh]hENOSPC}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhj`ubah}(h]h ]h"]h$]h&]uh1jEhhhK@hj]ubah}(h]h ]h"]h$]h&]uh1j@hjZubjA)}(hhh]jF)}(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).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhhhKBhj}ubah}(h]h ]h"]h$]h&]uh1j@hjZubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``EPERM``h]jL)}(hjh]hEPERM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhjubah}(h]h ]h"]h$]h&]uh1jEhhhKFhjubah}(h]h ]h"]h$]h&]uh1j@hjubjA)}(hhh]jF)}(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&]uh1jEhhhKHhjubah}(h]h ]h"]h$]h&]uh1j@hjubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h``EIO``h]jL)}(hjh]hEIO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jKhjubah}(h]h ]h"]h$]h&]uh1jEhhhKKhjubah}(h]h ]h"]h$]h&]uh1j@hjubjA)}(hhh]jF)}(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&]uh1jEhhhKMhjubah}(h]h ]h"]h$]h&]uh1j@hjubeh}(h]h ]h"]h$]h&]uh1j;hj8ubj<)}(hhh](jA)}(hhh]jF)}(h ``ENXIO``h]jL)}(hj"h]hENXIO}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jKhj ubah}(h]h ]h"]h$]h&]uh1jEhhhKQhjubah}(h]h ]h"]h$]h&]uh1j@hjubjA)}(hhh]jF)}(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&]uh1jEhhhKShj=ubah}(h]h ]h"]h$]h&]uh1j@hjubeh}(h]h ]h"]h$]h&]uh1j;hj8ubeh}(h]h ]h"]h$]h&]uh1j6hjubeh}(h]h ]h"]h$]h&]colsKuh1jhj ubeh}(h]id2ah ]h"]h$]h&]uh1jhhhhhNhNubhnote)}(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]jF)}(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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhhhKXhj{ubah}(h]h ]h"]h$]h&]uh1jyhjvubjz)}(hPRequest-specific error codes are listed in the individual requests descriptions.h]jF)}(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&]uh1jEhhhK]hjubah}(h]h ]h"]h$]h&]uh1jyhjvubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1jthjpubah}(h]h ]h"]h$]h&]uh1jnhhhhhNhNubeh}(h](generic-error-codesheh ]h"](generic error codes gen_errorseh$]h&]uh1hhhhhhhhKj}jhsj}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_sourcehnj _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}(hhjhhhjij u 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]jF)}(hhh]h0Hyperlink target "gen-errors" is not referenced.}hjTsbah}(h]h ]h"]h$]h&]uh1jEhjQubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehnjlineKuh1jOubjP)}(hhh]jF)}(hhh]h)Hyperlink target "id1" is not referenced.}hjosbah}(h]h ]h"]h$]h&]uh1jEhjlubah}(h]h ]h"]h$]h&]levelKtypejisourcehnjlineK uh1jOube transformerN include_log] decorationNhhub.