154f38fcaSMauro Carvalho Chehab.. Permission is granted to copy, distribute and/or modify this 254f38fcaSMauro Carvalho Chehab.. document under the terms of the GNU Free Documentation License, 354f38fcaSMauro Carvalho Chehab.. Version 1.1 or any later version published by the Free Software 454f38fcaSMauro Carvalho Chehab.. Foundation, with no Invariant Sections, no Front-Cover Texts 554f38fcaSMauro Carvalho Chehab.. and no Back-Cover Texts. A copy of the license is included at 654f38fcaSMauro Carvalho Chehab.. Documentation/userspace-api/media/fdl-appendix.rst. 754f38fcaSMauro Carvalho Chehab.. 854f38fcaSMauro Carvalho Chehab.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections 954f38fcaSMauro Carvalho Chehab 1054f38fcaSMauro Carvalho Chehab.. _DMX_GET_STC: 1154f38fcaSMauro Carvalho Chehab 1254f38fcaSMauro Carvalho Chehab=========== 1354f38fcaSMauro Carvalho ChehabDMX_GET_STC 1454f38fcaSMauro Carvalho Chehab=========== 1554f38fcaSMauro Carvalho Chehab 1654f38fcaSMauro Carvalho ChehabName 1754f38fcaSMauro Carvalho Chehab---- 1854f38fcaSMauro Carvalho Chehab 1954f38fcaSMauro Carvalho ChehabDMX_GET_STC 2054f38fcaSMauro Carvalho Chehab 2154f38fcaSMauro Carvalho Chehab 2254f38fcaSMauro Carvalho ChehabSynopsis 2354f38fcaSMauro Carvalho Chehab-------- 2454f38fcaSMauro Carvalho Chehab 2554f38fcaSMauro Carvalho Chehab.. c:function:: int ioctl( int fd, DMX_GET_STC, struct dmx_stc *stc) 2654f38fcaSMauro Carvalho Chehab :name: DMX_GET_STC 2754f38fcaSMauro Carvalho Chehab 2854f38fcaSMauro Carvalho ChehabArguments 2954f38fcaSMauro Carvalho Chehab--------- 3054f38fcaSMauro Carvalho Chehab 3154f38fcaSMauro Carvalho Chehab``fd`` 3254f38fcaSMauro Carvalho Chehab File descriptor returned by :c:func:`open() <dvb-dmx-open>`. 3354f38fcaSMauro Carvalho Chehab 3454f38fcaSMauro Carvalho Chehab``stc`` 3554f38fcaSMauro Carvalho Chehab Pointer to :c:type:`dmx_stc` where the stc data is to be stored. 3654f38fcaSMauro Carvalho Chehab 3754f38fcaSMauro Carvalho Chehab 3854f38fcaSMauro Carvalho ChehabDescription 3954f38fcaSMauro Carvalho Chehab----------- 4054f38fcaSMauro Carvalho Chehab 4154f38fcaSMauro Carvalho ChehabThis ioctl call returns the current value of the system time counter 4254f38fcaSMauro Carvalho Chehab(which is driven by a PES filter of type :c:type:`DMX_PES_PCR <dmx_ts_pes>`). 4354f38fcaSMauro Carvalho ChehabSome hardware supports more than one STC, so you must specify which one by 4454f38fcaSMauro Carvalho Chehabsetting the :c:type:`num <dmx_stc>` field of stc before the ioctl (range 0...n). 4554f38fcaSMauro Carvalho ChehabThe result is returned in form of a ratio with a 64 bit numerator 4654f38fcaSMauro Carvalho Chehaband a 32 bit denominator, so the real 90kHz STC value is 4754f38fcaSMauro Carvalho Chehab``stc->stc / stc->base``. 4854f38fcaSMauro Carvalho Chehab 4954f38fcaSMauro Carvalho Chehab 5054f38fcaSMauro Carvalho ChehabReturn Value 5154f38fcaSMauro Carvalho Chehab------------ 5254f38fcaSMauro Carvalho Chehab 5354f38fcaSMauro Carvalho ChehabOn success 0 is returned. 5454f38fcaSMauro Carvalho Chehab 5554f38fcaSMauro Carvalho ChehabOn error -1 is returned, and the ``errno`` variable is set 5654f38fcaSMauro Carvalho Chehabappropriately. 5754f38fcaSMauro Carvalho Chehab 5854f38fcaSMauro Carvalho Chehab.. tabularcolumns:: |p{2.5cm}|p{15.0cm}| 5954f38fcaSMauro Carvalho Chehab 6054f38fcaSMauro Carvalho Chehab.. flat-table:: 6154f38fcaSMauro Carvalho Chehab :header-rows: 0 6254f38fcaSMauro Carvalho Chehab :stub-columns: 0 6354f38fcaSMauro Carvalho Chehab :widths: 1 16 6454f38fcaSMauro Carvalho Chehab 6554f38fcaSMauro Carvalho Chehab - .. row 1 6654f38fcaSMauro Carvalho Chehab 6754f38fcaSMauro Carvalho Chehab - ``EINVAL`` 6854f38fcaSMauro Carvalho Chehab 6954f38fcaSMauro Carvalho Chehab - Invalid stc number. 7054f38fcaSMauro Carvalho Chehab 7154f38fcaSMauro Carvalho Chehab 7254f38fcaSMauro Carvalho ChehabThe generic error codes are described at the 7354f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter. 74