Xsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftargetD/translations/zh_CN/userspace-api/media/cec/cec-ioc-adap-g-phys-addrmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/zh_TW/userspace-api/media/cec/cec-ioc-adap-g-phys-addrmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/it_IT/userspace-api/media/cec/cec-ioc-adap-g-phys-addrmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/ja_JP/userspace-api/media/cec/cec-ioc-adap-g-phys-addrmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/ko_KR/userspace-api/media/cec/cec-ioc-adap-g-phys-addrmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetD/translations/sp_SP/userspace-api/media/cec/cec-ioc-adap-g-phys-addrmodnameN 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:spacepreserveuh1hhhhhh^/var/lib/git/docbuild/linux/Documentation/userspace-api/media/cec/cec-ioc-adap-g-phys-addr.rsthKubhtarget)}(h.. _CEC_ADAP_PHYS_ADDR:h]h}(h]h ]h"]h$]h&]refidcec-adap-phys-addruh1hhKhhhhhhubh)}(h.. _CEC_ADAP_G_PHYS_ADDR:h]h}(h]h ]h"]h$]h&]hcec-adap-g-phys-addruh1hhKhhhhhhexpect_referenced_by_name}cec_adap_phys_addrhsexpect_referenced_by_id}hhsubh)}(h.. _CEC_ADAP_S_PHYS_ADDR:h]h}(h]h ]h"]h$]h&]hcec-adap-s-phys-addruh1hhKhhhhhhh}(cec_adap_g_phys_addrhhhuh}(hhhhuubhsection)}(hhh](htitle)}(h4ioctls CEC_ADAP_G_PHYS_ADDR and CEC_ADAP_S_PHYS_ADDRh]h4ioctls CEC_ADAP_G_PHYS_ADDR and CEC_ADAP_S_PHYS_ADDR}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hNameh]hName}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh paragraph)}(hLCEC_ADAP_G_PHYS_ADDR, CEC_ADAP_S_PHYS_ADDR - Get or set the physical addressh]hLCEC_ADAP_G_PHYS_ADDR, CEC_ADAP_S_PHYS_ADDR - Get or set the physical address}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhhhhubeh}(h]nameah ]h"]nameah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hSynopsish]hSynopsis}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single"CEC.CEC_ADAP_G_PHYS_ADDR (C macro)c.CEC.CEC_ADAP_G_PHYS_ADDRhNtauh1j/hjhhhNhNubhdesc)}(hhh](hdesc_signature)}(hCEC_ADAP_G_PHYS_ADDRh]hdesc_signature_line)}(hCEC_ADAP_G_PHYS_ADDRh]h desc_name)}(hCEC_ADAP_G_PHYS_ADDRh]h desc_sig_name)}(hjIh]hCEC_ADAP_G_PHYS_ADDR}(hjYhhhNhNubah}(h]h ]nah"]h$]h&]uh1jWhjSubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jQhjMhhhhhKubah}(h]h ]h"]h$]h&]hh add_permalinkuh1jKsphinx_line_type declaratorhjGhhhhhKubah}(h]j>ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jEhhhKhjBhhubh desc_content)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjBhhhhhKubeh}(h]h ](cmacroeh"]h$]h&]domainjobjtypejdesctypejnoindex noindexentrynocontentsentryuh1j@hhhjhNhNubj)}(h8``int ioctl(int fd, CEC_ADAP_G_PHYS_ADDR, __u16 *argp)``h]hliteral)}(hjh]h4int ioctl(int fd, CEC_ADAP_G_PHYS_ADDR, __u16 *argp)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj0)}(hhh]h}(h]h ]h"]h$]h&]entries](j<"CEC.CEC_ADAP_S_PHYS_ADDR (C macro)c.CEC.CEC_ADAP_S_PHYS_ADDRhNtauh1j/hjhhhNhNubjA)}(hhh](jF)}(hCEC_ADAP_S_PHYS_ADDRh]jL)}(hCEC_ADAP_S_PHYS_ADDRh]jR)}(hCEC_ADAP_S_PHYS_ADDRh]jX)}(hjh]hCEC_ADAP_S_PHYS_ADDR}(hjhhhNhNubah}(h]h ]jcah"]h$]h&]uh1jWhjubah}(h]h ](jjjkeh"]h$]h&]hhuh1jQhjhhhhhKubah}(h]h ]h"]h$]h&]hhjuuh1jKjvjwhjhhhhhKubah}(h]jah ](j{j|eh"]h$]h&]jj)jhuh1jEhhhKhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhhhKubeh}(h]h ](jmacroeh"]h$]h&]jjjjjjjjjuh1j@hhhjhNhNubj)}(h8``int ioctl(int fd, CEC_ADAP_S_PHYS_ADDR, __u16 *argp)``h]j)}(hjh]h4int ioctl(int fd, CEC_ADAP_S_PHYS_ADDR, __u16 *argp)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]synopsisah ]h"]synopsisah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Argumentsh]h Arguments}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubhdefinition_list)}(hhh](hdefinition_list_item)}(h5``fd`` File descriptor returned by :c:func:`open()`. h](hterm)}(h``fd``h]j)}(hj@h]hfd}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1j<hhhK hj8ubh definition)}(hhh]j)}(h-File descriptor returned by :c:func:`open()`.h](hFile descriptor returned by }(hjZhhhNhNubh)}(h:c:func:`open()`h]j)}(hjdh]hopen()}(hjfhhhNhNubah}(h]h ](xrefjc-funceh"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&]refdoc0userspace-api/media/cec/cec-ioc-adap-g-phys-addr refdomainjreftypefunc refexplicitrefwarn c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)} identifierCECsbNasb reftargetopenuh1hhhhK hjZubh.}(hjZhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhK hjWubah}(h]h ]h"]h$]h&]uh1jUhj8ubeh}(h]h ]h"]h$]h&]uh1j6hhhK hj3ubj7)}(h%``argp`` Pointer to the CEC address. h](j=)}(h``argp``h]j)}(hjh]hargp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1j<hhhK#hjubjV)}(hhh]j)}(hPointer to the CEC address.h]hPointer to the CEC address.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhK#hjubah}(h]h ]h"]h$]h&]uh1jUhjubeh}(h]h ]h"]h$]h&]uh1j6hhhK#hj3hhubeh}(h]h ]h"]h$]h&]uh1j1hj hhhhhNubeh}(h] argumentsah ]h"] argumentsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Descriptionh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK&ubj)}(hTo query the current physical address applications call :ref:`ioctl CEC_ADAP_G_PHYS_ADDR ` with a pointer to a __u16 where the driver stores the physical address.h](h8To query the current physical address applications call }(hjhhhNhNubh)}(h8:ref:`ioctl CEC_ADAP_G_PHYS_ADDR `h]hinline)}(hj h]hioctl CEC_ADAP_G_PHYS_ADDR}(hjhhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hjubah}(h]h ]h"]h$]h&]refdocj| refdomainjreftyperef refexplicitrefwarnjcec_adap_g_phys_addruh1hhhhK(hjubhH with a pointer to a __u16 where the driver stores the physical address.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhK(hjhhubj)}(hXTo set a new physical address applications store the physical address in a __u16 and call :ref:`ioctl CEC_ADAP_S_PHYS_ADDR ` with a pointer to this integer. The :ref:`ioctl CEC_ADAP_S_PHYS_ADDR ` is only available if ``CEC_CAP_PHYS_ADDR`` is set (the ``ENOTTY`` error code will be returned otherwise). The :ref:`ioctl CEC_ADAP_S_PHYS_ADDR ` can only be called by a file descriptor in initiator mode (see :ref:`CEC_S_MODE`), if not the ``EBUSY`` error code will be returned.h](hZTo set a new physical address applications store the physical address in a __u16 and call }(hj4hhhNhNubh)}(h8:ref:`ioctl CEC_ADAP_S_PHYS_ADDR `h]j )}(hj>h]hioctl CEC_ADAP_S_PHYS_ADDR}(hj@hhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hj<ubah}(h]h ]h"]h$]h&]refdocj| refdomainjJreftyperef refexplicitrefwarnjcec_adap_s_phys_addruh1hhhhK,hj4ubh% with a pointer to this integer. The }(hj4hhhNhNubh)}(h8:ref:`ioctl CEC_ADAP_S_PHYS_ADDR `h]j )}(hjbh]hioctl CEC_ADAP_S_PHYS_ADDR}(hjdhhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hj`ubah}(h]h ]h"]h$]h&]refdocj| refdomainjnreftyperef refexplicitrefwarnjcec_adap_s_phys_addruh1hhhhK,hj4ubh is only available if }(hj4hhhNhNubj)}(h``CEC_CAP_PHYS_ADDR``h]hCEC_CAP_PHYS_ADDR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh is set (the }(hj4hhhNhNubj)}(h ``ENOTTY``h]hENOTTY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh- error code will be returned otherwise). The }(hj4hhhNhNubh)}(h8:ref:`ioctl CEC_ADAP_S_PHYS_ADDR `h]j )}(hjh]hioctl CEC_ADAP_S_PHYS_ADDR}(hjhhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hjubah}(h]h ]h"]h$]h&]refdocj| refdomainjreftyperef refexplicitrefwarnjcec_adap_s_phys_addruh1hhhhK,hj4ubh@ can only be called by a file descriptor in initiator mode (see }(hj4hhhNhNubh)}(h:ref:`CEC_S_MODE`h]j )}(hjh]h CEC_S_MODE}(hjhhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hjubah}(h]h ]h"]h$]h&]refdocj| refdomainjreftyperef refexplicitrefwarnj cec_s_modeuh1hhhhK,hj4ubh), if not the }(hj4hhhNhNubj)}(h ``EBUSY``h]hEBUSY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubh error code will be returned.}(hj4hhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhK,hjhhubj)}(hsTo clear an existing physical address use ``CEC_PHYS_ADDR_INVALID``. The adapter will go to the unconfigured state.h](h*To clear an existing physical address use }(hjhhhNhNubj)}(h``CEC_PHYS_ADDR_INVALID``h]hCEC_PHYS_ADDR_INVALID}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh0. The adapter will go to the unconfigured state.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhK4hjhhubj)}(hXGIf logical address types have been defined (see :ref:`ioctl CEC_ADAP_S_LOG_ADDRS `), then this ioctl will block until all requested logical addresses have been claimed. If the file descriptor is in non-blocking mode then it will not wait for the logical addresses to be claimed, instead it just returns 0.h](h0If logical address types have been defined (see }(hj(hhhNhNubh)}(h8:ref:`ioctl CEC_ADAP_S_LOG_ADDRS `h]j )}(hj2h]hioctl CEC_ADAP_S_LOG_ADDRS}(hj4hhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hj0ubah}(h]h ]h"]h$]h&]refdocj| refdomainj>reftyperef refexplicitrefwarnjcec_adap_s_log_addrsuh1hhhhK7hj(ubh), then this ioctl will block until all requested logical addresses have been claimed. If the file descriptor is in non-blocking mode then it will not wait for the logical addresses to be claimed, instead it just returns 0.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhK7hjhhubj)}(hiA :ref:`CEC_EVENT_STATE_CHANGE ` event is sent when the physical address changes.h](hA }(hjZhhhNhNubh)}(h6:ref:`CEC_EVENT_STATE_CHANGE `h]j )}(hjdh]hCEC_EVENT_STATE_CHANGE}(hjfhhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hjbubah}(h]h ]h"]h$]h&]refdocj| refdomainjpreftyperef refexplicitrefwarnjcec-event-state-changeuh1hhhhK` chapter.h](h.On success 0 is returned, on error -1 and the }(hjhhhNhNubj)}(h ``errno``h]herrno}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhM variable is set appropriately. The generic error codes are described at the }(hjhhhNhNubh)}(h':ref:`Generic Error Codes `h]j )}(hjh]hGeneric Error Codes}(hjhhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hjubah}(h]h ]h"]h$]h&]refdocj| refdomainjreftyperef refexplicitrefwarnj gen-errorsuh1hhhhKOhjubh chapter.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhKOhjhhubj)}(hbThe :ref:`ioctl CEC_ADAP_S_PHYS_ADDR ` can return the following error codes:h](hThe }(hjhhhNhNubh)}(h8:ref:`ioctl CEC_ADAP_S_PHYS_ADDR `h]j )}(hjh]hioctl CEC_ADAP_S_PHYS_ADDR}(hjhhhNhNubah}(h]h ](jpstdstd-refeh"]h$]h&]uh1j hj ubah}(h]h ]h"]h$]h&]refdocj| refdomainjreftyperef refexplicitrefwarnjcec_adap_s_phys_addruh1hhhhKShjubh& can return the following error codes:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhKShjhhubj2)}(hhh](j7)}(hXENOTTY The ``CEC_CAP_PHYS_ADDR`` capability wasn't set, so this ioctl is not supported. h](j=)}(hENOTTYh]hENOTTY}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1j<hhhKWhj:ubjV)}(hhh]j)}(hPThe ``CEC_CAP_PHYS_ADDR`` capability wasn't set, so this ioctl is not supported.h](hThe }(hjOhhhNhNubj)}(h``CEC_CAP_PHYS_ADDR``h]hCEC_CAP_PHYS_ADDR}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjOubh9 capability wasn’t set, so this ioctl is not supported.}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhKWhjLubah}(h]h ]h"]h$]h&]uh1jUhj:ubeh}(h]h ]h"]h$]h&]uh1j6hhhKWhj7ubj7)}(h}EBUSY Another filehandle is in exclusive follower or initiator mode, or the filehandle is in mode ``CEC_MODE_NO_INITIATOR``. h](j=)}(hEBUSYh]hEBUSY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hhhK[hj{ubjV)}(hhh]j)}(hvAnother filehandle is in exclusive follower or initiator mode, or the filehandle is in mode ``CEC_MODE_NO_INITIATOR``.h](h\Another filehandle is in exclusive follower or initiator mode, or the filehandle is in mode }(hjhhhNhNubj)}(h``CEC_MODE_NO_INITIATOR``h]hCEC_MODE_NO_INITIATOR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jhhhKZhjubah}(h]h ]h"]h$]h&]uh1jUhj{ubeh}(h]h ]h"]h$]h&]uh1j6hhhK[hj7hhubj7)}(h)EINVAL The physical address is malformed.h](j=)}(hEINVALh]hEINVAL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j<hhhK]hjubjV)}(hhh]j)}(h"The physical address is malformed.h]h"The physical address is malformed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhK^hjubah}(h]h ]h"]h$]h&]uh1jUhjubeh}(h]h ]h"]h$]h&]uh1j6hhhK]hj7hhubeh}(h]h ]h"]h$]h&]uh1j1hjhhhhhNubeh}(h] return-valueah ]h"] return valueah$]h&]uh1hhhhhhhhKMubeh}(h](4ioctls-cec-adap-g-phys-addr-and-cec-adap-s-phys-addrhhheh ]h"](4ioctls cec_adap_g_phys_addr and cec_adap_s_phys_addrcec_adap_s_phys_addrhheh$]h&]uh1hhhhhhhhK h}(jhhhhhuh}(hhhhhhuubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_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_handlerj'error_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]hah]haunameids}(hhhhjhjjjjjjjjjjjju nametypes}(hψhވjjjjjjjuh}(hhhhhhjhjhjjj>jGjjjj jjjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages](hsystem_message)}(hhh]j)}(hhh]h8Hyperlink target "cec-adap-phys-addr" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1jubj)}(hhh]j)}(hhh]h:Hyperlink target "cec-adap-g-phys-addr" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]levelKtypejsourcehlineKuh1jubj)}(hhh]j)}(hhh]h:Hyperlink target "cec-adap-s-phys-addr" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]levelKtypejsourcehlineKuh1jube transformerN include_log] decorationNhhub.