€•;Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”ŒE/translations/zh_CN/userspace-api/media/mediactl/media-ioc-setup-link”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒE/translations/zh_TW/userspace-api/media/mediactl/media-ioc-setup-link”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒE/translations/it_IT/userspace-api/media/mediactl/media-ioc-setup-link”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒE/translations/ja_JP/userspace-api/media/mediactl/media-ioc-setup-link”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒE/translations/ko_KR/userspace-api/media/mediactl/media-ioc-setup-link”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒE/translations/sp_SP/userspace-api/media/mediactl/media-ioc-setup-link”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later”h]”hŒ8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1h¡hhhžhhŸŒ_/var/lib/git/docbuild/linux/Documentation/userspace-api/media/mediactl/media-ioc-setup-link.rst”h KubhŒtarget”“”)”}”(hŒ.. _media_ioc_setup_link:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œmedia-ioc-setup-link”uh1h´h KhhhžhhŸh³ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒioctl MEDIA_IOC_SETUP_LINK”h]”hŒioctl MEDIA_IOC_SETUP_LINK”…””}”(hhÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒName”h]”hŒName”…””}”(hhÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhh×hžhhŸh³h K ubhŒ paragraph”“”)”}”(hŒ6MEDIA_IOC_SETUP_LINK - Modify the properties of a link”h]”hŒ6MEDIA_IOC_SETUP_LINK - Modify the properties of a link”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K hh×hžhubeh}”(h]”Œname”ah ]”h"]”Œname”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K ubhÃ)”}”(hhh]”(hÈ)”}”(hŒSynopsis”h]”hŒSynopsis”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjhžhhŸh³h KubhŒindex”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œentries”]”(Œsingle”Œ!MC.MEDIA_IOC_SETUP_LINK (C macro)”Œc.MC.MEDIA_IOC_SETUP_LINK”hNt”auh1jhjhžhhŸNh NubhŒdesc”“”)”}”(hhh]”(hŒdesc_signature”“”)”}”(hŒMEDIA_IOC_SETUP_LINK”h]”hŒdesc_signature_line”“”)”}”(hŒMEDIA_IOC_SETUP_LINK”h]”hŒ desc_name”“”)”}”(hŒMEDIA_IOC_SETUP_LINK”h]”hŒ desc_sig_name”“”)”}”(hj+h]”hŒMEDIA_IOC_SETUP_LINK”…””}”(hj;hžhhŸNh Nubah}”(h]”h ]”Œn”ah"]”h$]”h&]”uh1j9hj5ubah}”(h]”h ]”(Œsig-name”Œdescname”eh"]”h$]”h&]”h±h²uh1j3hj/hžhhŸh³h Kubah}”(h]”h ]”h"]”h$]”h&]”h±h²Œ add_permalink”ˆuh1j-Œsphinx_line_type”Œ declarator”hj)hžhhŸh³h Kubah}”(h]”j ah ]”(Œsig”Œ sig-object”eh"]”h$]”h&]”Œ is_multiline”ˆŒ _toc_parts”)Œ _toc_name”huh1j'hŸh³h Khj$hžhubhŒ desc_content”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”uh1jehj$hžhhŸh³h Kubeh}”(h]”h ]”(Œc”Œmacro”eh"]”h$]”h&]”Œdomain”jsŒobjtype”jtŒdesctype”jtŒnoindex”‰Œ noindexentry”‰Œnocontentsentry”‰uh1j"hžhhjhŸNh Nubhé)”}”(hŒI``int ioctl(int fd, MEDIA_IOC_SETUP_LINK, struct media_link_desc *argp)``”h]”hŒliteral”“”)”}”(hj€h]”hŒEint ioctl(int fd, MEDIA_IOC_SETUP_LINK, struct media_link_desc *argp)”…””}”(hj„hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hj~ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khjhžhubeh}”(h]”Œsynopsis”ah ]”h"]”Œsynopsis”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒ Arguments”h]”hŒ Arguments”…””}”(hj¢hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjŸhžhhŸh³h KubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ5``fd`` File descriptor returned by :c:func:`open()`. ”h]”(hŒterm”“”)”}”(hŒ``fd``”h]”jƒ)”}”(hj¿h]”hŒfd”…””}”(hjÁhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hj½ubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hŸh³h Khj·ubhŒ definition”“”)”}”(hhh]”hé)”}”(hŒ-File descriptor returned by :c:func:`open()`.”h]”(hŒFile descriptor returned by ”…””}”(hjÙhžhhŸNh Nubh)”}”(hŒ:c:func:`open()`”h]”jƒ)”}”(hjãh]”hŒopen()”…””}”(hjåhžhhŸNh Nubah}”(h]”h ]”(Œxref”jsŒc-func”eh"]”h$]”h&]”uh1j‚hjáubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ1userspace-api/media/mediactl/media-ioc-setup-link”Œ refdomain”jsŒreftype”Œfunc”Œ refexplicit”‰Œrefwarn”‰Œ c:parent_key”Œsphinx.domains.c”Œ LookupKey”“”)”}”Œdata”]”jŒ ASTIdentifier”“”)”}”Œ identifier”ŒMC”sbN†”asbŒ reftarget”Œopen”uh1hhŸh³h KhjÙubhŒ.”…””}”(hjÙhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KhjÖubah}”(h]”h ]”h"]”h$]”h&]”uh1jÔhj·ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jµhŸh³h Khj²ubj¶)”}”(hŒ6``argp`` Pointer to struct :c:type:`media_link_desc`. ”h]”(j¼)”}”(hŒ``argp``”h]”jƒ)”}”(hj.h]”hŒargp”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hj,ubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hŸh³h Khj(ubjÕ)”}”(hhh]”hé)”}”(hŒ,Pointer to struct :c:type:`media_link_desc`.”h]”(hŒPointer to struct ”…””}”(hjFhžhhŸNh Nubh)”}”(hŒ:c:type:`media_link_desc`”h]”jƒ)”}”(hjPh]”hŒmedia_link_desc”…””}”(hjRhžhhŸNh Nubah}”(h]”h ]”(jïjsŒc-type”eh"]”h$]”h&]”uh1j‚hjNubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jûŒ refdomain”jsŒreftype”Œtype”Œ refexplicit”‰Œrefwarn”‰jjjŒmedia_link_desc”uh1hhŸh³h KhjFubhŒ.”…””}”(hjFhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KhjCubah}”(h]”h ]”h"]”h$]”h&]”uh1jÔhj(ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jµhŸh³h Khj²hžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1j°hjŸhžhhŸh³h Nubeh}”(h]”Œ arguments”ah ]”h"]”Œ arguments”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒ Description”h]”hŒ Description”…””}”(hj”hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj‘hžhhŸh³h K ubhé)”}”(hŒûTo change link properties applications fill a struct :c:type:`media_link_desc` with link identification information (source and sink pad) and the new requested link flags. They then call the MEDIA_IOC_SETUP_LINK ioctl with a pointer to that structure.”h]”(hŒ5To change link properties applications fill a struct ”…””}”(hj¢hžhhŸNh Nubh)”}”(hŒ:c:type:`media_link_desc`”h]”jƒ)”}”(hj¬h]”hŒmedia_link_desc”…””}”(hj®hžhhŸNh Nubah}”(h]”h ]”(jïjsŒc-type”eh"]”h$]”h&]”uh1j‚hjªubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jûŒ refdomain”jsŒreftype”Œtype”Œ refexplicit”‰Œrefwarn”‰jjjŒmedia_link_desc”uh1hhŸh³h K"hj¢ubhŒ­ with link identification information (source and sink pad) and the new requested link flags. They then call the MEDIA_IOC_SETUP_LINK ioctl with a pointer to that structure.”…””}”(hj¢hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K"hj‘hžhubhé)”}”(hŒ£The only configurable property is the ``ENABLED`` link flag to enable/disable a link. Links marked with the ``IMMUTABLE`` link flag can not be enabled or disabled.”h]”(hŒ&The only configurable property is the ”…””}”(hjÓhžhhŸNh Nubjƒ)”}”(hŒ ``ENABLED``”h]”hŒENABLED”…””}”(hjÛhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hjÓubhŒ; link flag to enable/disable a link. Links marked with the ”…””}”(hjÓhžhhŸNh Nubjƒ)”}”(hŒ ``IMMUTABLE``”h]”hŒ IMMUTABLE”…””}”(hjíhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hjÓubhŒ* link flag can not be enabled or disabled.”…””}”(hjÓhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K(hj‘hžhubhé)”}”(hŒ¯Link configuration has no side effect on other links. If an enabled link at the sink pad prevents the link from being enabled, the driver returns with an ``EBUSY`` error code.”h]”(hŒšLink configuration has no side effect on other links. If an enabled link at the sink pad prevents the link from being enabled, the driver returns with an ”…””}”(hjhžhhŸNh Nubjƒ)”}”(hŒ ``EBUSY``”h]”hŒEBUSY”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hjubhŒ error code.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K,hj‘hžhubhé)”}”(hŒÆOnly links marked with the ``DYNAMIC`` link flag can be enabled/disabled while streaming media data. Attempting to enable or disable a streaming non-dynamic link will return an ``EBUSY`` error code.”h]”(hŒOnly links marked with the ”…””}”(hj%hžhhŸNh Nubjƒ)”}”(hŒ ``DYNAMIC``”h]”hŒDYNAMIC”…””}”(hj-hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hj%ubhŒ‹ link flag can be enabled/disabled while streaming media data. Attempting to enable or disable a streaming non-dynamic link will return an ”…””}”(hj%hžhhŸNh Nubjƒ)”}”(hŒ ``EBUSY``”h]”hŒEBUSY”…””}”(hj?hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hj%ubhŒ error code.”…””}”(hj%hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K0hj‘hžhubhé)”}”(hŒVIf the specified link can't be found the driver returns with an ``EINVAL`` error code.”h]”(hŒBIf the specified link can’t be found the driver returns with an ”…””}”(hjWhžhhŸNh Nubjƒ)”}”(hŒ ``EINVAL``”h]”hŒEINVAL”…””}”(hj_hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hjWubhŒ error code.”…””}”(hjWhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K4hj‘hžhubeh}”(h]”Œ description”ah ]”h"]”Œ description”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ Return Value”h]”hŒ Return Value”…””}”(hj‚hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjhžhhŸh³h K8ubhé)”}”(hŒ´On success 0 is returned, on error -1 and the ``errno`` variable is set appropriately. The generic error codes are described at the :ref:`Generic Error Codes ` chapter.”h]”(hŒ.On success 0 is returned, on error -1 and the ”…””}”(hjhžhhŸNh Nubjƒ)”}”(hŒ ``errno``”h]”hŒerrno”…””}”(hj˜hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚hjubhŒM variable is set appropriately. The generic error codes are described at the ”…””}”(hjhžhhŸNh Nubh)”}”(hŒ':ref:`Generic Error Codes `”h]”hŒinline”“”)”}”(hj¬h]”hŒGeneric Error Codes”…””}”(hj°hžhhŸNh Nubah}”(h]”h ]”(jïŒstd”Œstd-ref”eh"]”h$]”h&]”uh1j®hjªubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jûŒ refdomain”jºŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjŒ gen-errors”uh1hhŸh³h K:hjubhŒ chapter.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K:hjhžhubj±)”}”(hhh]”j¶)”}”(hŒ™EINVAL The struct :c:type:`media_link_desc` references a non-existing link, or the link is immutable and an attempt to modify its configuration was made.”h]”(j¼)”}”(hŒEINVAL”h]”hŒEINVAL”…””}”(hjÝhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j»hŸh³h K@hjÙubjÕ)”}”(hhh]”hé)”}”(hŒ’The struct :c:type:`media_link_desc` references a non-existing link, or the link is immutable and an attempt to modify its configuration was made.”h]”(hŒ The struct ”…””}”(hjîhžhhŸNh Nubh)”}”(hŒ:c:type:`media_link_desc`”h]”jƒ)”}”(hjøh]”hŒmedia_link_desc”…””}”(hjúhžhhŸNh Nubah}”(h]”h ]”(jïjsŒc-type”eh"]”h$]”h&]”uh1j‚hjöubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jûŒ refdomain”jsŒreftype”Œtype”Œ refexplicit”‰Œrefwarn”‰jjjŒmedia_link_desc”uh1hhŸh³h K?hjîubhŒn references a non-existing link, or the link is immutable and an attempt to modify its configuration was made.”…””}”(hjîhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K?hjëubah}”(h]”h ]”h"]”h$]”h&]”uh1jÔhjÙubeh}”(h]”h ]”h"]”h$]”h&]”uh1jµhŸh³h K@hjÖubah}”(h]”h ]”h"]”h$]”h&]”uh1j°hjhžhhŸh³h Nubeh}”(h]”Œ return-value”ah ]”h"]”Œ return value”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K8ubeh}”(h]”(Œioctl-media-ioc-setup-link”hÁeh ]”h"]”(Œioctl media_ioc_setup_link”Œmedia_ioc_setup_link”eh$]”h&]”uh1hÂhhhžhhŸh³h KŒexpect_referenced_by_name”}”j?h¶sŒexpect_referenced_by_id”}”hÁh¶subeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÇNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jiŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”hÁ]”h¶asŒnameids”}”(j?hÁj>j;hýhújœj™jŽj‹j|jyj6j3uŒ nametypes”}”(j?ˆj>‰hý‰jœ‰jމj|‰j6‰uh}”(hÁhÄj;hÄhúh×j™jj j)j‹jŸjyj‘j3juŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”hŒsystem_message”“”)”}”(hhh]”hé)”}”(hhh]”hŒ:Hyperlink target "media-ioc-setup-link" is not referenced.”…””}”hjÓsbah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjÐubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jÎubaŒ transformer”NŒ include_log”]”Œ decoration”Nhžhub.