1.. -*- coding: utf-8; mode: rst -*- 2 3.. _media_ioc_setup_link: 4 5************************** 6ioctl MEDIA_IOC_SETUP_LINK 7************************** 8 9Name 10==== 11 12MEDIA_IOC_SETUP_LINK - Modify the properties of a link 13 14 15Synopsis 16======== 17 18.. c:function:: int ioctl( int fd, MEDIA_IOC_SETUP_LINK, struct media_link_desc *argp ) 19 :name: MEDIA_IOC_SETUP_LINK 20 21 22Arguments 23========= 24 25``fd`` 26 File descriptor returned by :ref:`open() <media-func-open>`. 27 28``argp`` 29 30 31Description 32=========== 33 34To change link properties applications fill a struct 35:c:type:`media_link_desc` with link identification 36information (source and sink pad) and the new requested link flags. They 37then call the MEDIA_IOC_SETUP_LINK ioctl with a pointer to that 38structure. 39 40The only configurable property is the ``ENABLED`` link flag to 41enable/disable a link. Links marked with the ``IMMUTABLE`` link flag can 42not be enabled or disabled. 43 44Link configuration has no side effect on other links. If an enabled link 45at the sink pad prevents the link from being enabled, the driver returns 46with an ``EBUSY`` error code. 47 48Only links marked with the ``DYNAMIC`` link flag can be enabled/disabled 49while streaming media data. Attempting to enable or disable a streaming 50non-dynamic link will return an ``EBUSY`` error code. 51 52If the specified link can't be found the driver returns with an ``EINVAL`` 53error code. 54 55 56Return Value 57============ 58 59On success 0 is returned, on error -1 and the ``errno`` variable is set 60appropriately. The generic error codes are described at the 61:ref:`Generic Error Codes <gen-errors>` chapter. 62 63EINVAL 64 The struct :c:type:`media_link_desc` references a 65 non-existing link, or the link is immutable and an attempt to modify 66 its configuration was made. 67