libdvbv5: add a missing macro to dvb_table group for documentation

Minor fix: one of the macros of atsc_eit.h to the dvb_table
group.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

cv4l-helpers: add missing ioctls

This adds all remaining relevant ioctls to the cv4l_fd class.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

qv4l2: the helper now zeroes bytesperline

So we no longer need to do it in qv4l2.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

(c)v4l-helpers: zero bytesperline, swap arg order

When calling try/s_fmt optionally zero bytesperline.

Also swap the order of the last two arguments of v4l_format_s_bytesperline
and v4l_format_s_sizeimage to be consistent with other helper functions.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

buildsystem: Use latest ax_prog_doxygen from GNU Autoconf Archive

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

libdvbv5: group documentation into modules

In order to help digging into the documentation, put each
documented block into a group.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5 documentation review

General cleanup at the libdvbv5 documentation, in order to fix
some minor issues.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add support for mgt.h

With that, all tables are documented via doxygen.

We're still missing documentation for the desc_*.h headers.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add documentation for cat.h and atsc_header.h

Add tags for doxygen to process those two headers.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: don't use DVB_DESC_HEADER() macro

This macro was a very bad idea, as it causes doxygen to produce
wrong data. Get rid of it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: don't use ATSC_HEADER() macro

This macro was a very bad idea, as it causes doxygen to produce
wrong data. Get rid of it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add documentation for ATSC EIT.

ATSC EIT is different than the DVB EIT table. Document it, and
be sure that the DVB EIT table will be better described.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Add a mainpage to the documentation

Let's add a mainpage to the documentation, and do some
cleanup on other pages.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Add documentation for EIT DVB parser

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add documentation for crc32.h

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add documentation for the NIT table parser

Add doxygen documentation for nit.h.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: some documentation fixups for sdt.h

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add documentation for sdt.h

Add doxygen documentation for the contents of sdt.h.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: fix some issues at PAT documentation

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: better comment the descriptors

Add a @brief to each descriptor at descriptors.h, explaining from
what spec the descriptor came.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add doxygen tags to pmt.h

Add documentation for the MPEG-TS PMT table parser

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: fix some cut-and-paste errors at documentation

Forgot to rename some fields while cut-and-pasting from vct.h.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

doxygen_libdvbv5.cfg: add header.h, vct.h and pat.h

Add those 3 headers to doxygen documentation generator.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add doxygen tags to pat.h

Add documentation for the MPEG-TS table parser

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add doxygen tags to vct.h

Add documentation for the ATSC VCT table parser

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add doxygen tags for header.h

Add documentation for the MPEG-TS headers.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

v4l2-compliance: fix buffer state test

This test checks that a buffer can only be in a single state,
i.e. it can't be both QUEUED and DONE. But it also counted ERROR
as a separate state, but that's incorrect. ERROR is a separate
flag, independent of state.

Fix this test accordingly.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

Start v4l-utils 1.5.0 development cycle

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

Prepare for 1.4.0 release

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

libdvbv5 doxygen: Some improvements for dvb-scan.h and descriptors.h

There are some troubles caused by a wrong macro expansion at
doxygen. Fix them.

Also, tag the code examples as such.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Add more data about the descriptors definition

Better document descriptors.h by adding the specs used by the
descriptors found on this header at the javadoc macro.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

ir-keytable: Genrate stable map file by sorting directory before parsing

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

v4l2-ctl: Distribute vivid-tpg.h.patch

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

media-ctl: process pkgconfig files

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

contrib: Add au0828 directory to extra distribution list

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

libdvbv5: Add dvb-fe-priv.h to sources list

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

libdvbv5: Add doxygen config file to distribution list

Signed-off-by: Gregor Jasny <gjasny@googlemail.com>

libdvbv5: add documentation for descriptors.h

Add javadoc headers to document the content of descriptors.h,
and makes doxygen to generate the data (almost) properly.

Not sure why, but struct dvb_descriptor is not being
parsed properly by doxygen.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: get rid of bcd_to_int()

This function used to be needed by some descriptors, but it
is now unused. Remove it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Provide a quality indicator for DVB-T

Add a logic to provide a quality indicator for DVB-T

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Fix dvb_get_pmt_pid()

A previous patch broke it, by not renaming the name of the
file descriptor. Also, don't close the descriptor on error.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5 doxygen: Fix a few file descriptions

Some file descriptions weren't ok. Fix them.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: improve doxygen documentation

Add more tags to the header files, in order to improve the
documentation output.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: fix dvb_get_pmt_pid API

All functions on the demux API uses an opened fd, except for
dvb_get_pmt_pid() that were using a filename.

Change it to make the API coherent.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Properly document macros at dvb-v5-std.h

Macros require some special things to be properly parsed
by doxygen.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Fix function definitions at doxygen book

Parsing functions require some changes, otherwise the files
aren't properly parsed by doxygen.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

Ignore the generate doxygen-doc directory

This directory is autogenerated by the doxygen targets.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Improve doxygen format

Use a better template to generate Doxygen documentation.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

Add support to generate Doxygen documentation for libdvbv5

Add a way to auto-generate documentation for libdvbv5 using
Doxygen.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Convert documentation to javadoc format

We were using the documentation format as described inside
the Kernel. However, using javadoc format makes easier for
some tools like doxygen to parse. So, use it instead.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Document the last undocumented structs at dvb-file.h

With this addition, Doxygen should now be able to generate
documentation for all structs at the selected files.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Document the libdvbv5 properties

Document the userspace properties defined inside libdvbv5.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add documentation for the DVB scan functions

Explain how the DVB scan functions should be used, and
provide some usage examples.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: remove unused parameter at dvb_scan_alloc_handler_table()

The verbose parameter is never used. Remove it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Remove an unused parameter at struct dvb_v5_descriptors

verbose field is only initialized but never used. Remove it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Document dvb-log.h and dvb-sat.h

Add documentation to those two additional headers.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Add documentation for other functions at dvb-file.h

Add description for the functions related to properties filling,
and ancillary functions at dvb-file.h.

The only two functions missing descriptions are the ones that
are mostly internal to the library (yet, they might be useful
externally, so let's keep them at the public header).

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add documentation about format read/write functions

Document the most useful functions to read/write DVB channel
files.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: move PTABLE macro to the *.c files

This macro is not generic enough to be part of the library.
Also, its name can cause conflicts with other packages.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: rename enum file_formats to dvb_file_formats

file_formats is a too generic name, and can conflict with some
other symbol defined on another library.

So, rename it to dvb_file_formats.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

dvb-file.h: prepend parsing structs with "dvb_"

In order to avoid possible conflicts with other APIs, let's
prepend everything with dvb_.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Add a description for DVB file entries

Start documenting the contents of dvb-file.h. On this patch,
adds documentation to the structs that are visible by
most libdvbv5 applications.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: rename struct el_pid

This name is not good enough, as this struct name is
visible outside the DVB API. So, better name it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add documentation for dvb-demux.h

Now that we're exposing the library, better to have some
documentation for it.

While here, update the copyrights at the header.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

dvbv5-zap: remove an unused var

status var is never used at get_show_stats().

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

dvbv5-zap: Be sure to get stats before printing

On several places, the application is just showing the last value.
Be sure to refresh the stats before printing.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

dvbv5-zap: keep monitoring stats at DVB record mode

Instead of just waiting, keep monitoring the DVB stats.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: fix a corner case reported by Coverity

As Coverity reports:

305      if (table->size) {
306      for (j = 0; j < table->size; j++)
>>>     CID 1237263:  Dereference after null check  (FORWARD_NULL)
>>>     Passing null pointer "p" to "strcasecmp", which dereferences it.
307      if (!table->table[j] || !strcasecmp(table->table[j], p))
308      break;

This actually never happens in practice, as table->size is always
zero when the default_value is set (with is the only case where
the code can be called.

Yet, to avoid potential future issues, add an extra check if
the pointer p is valid.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Fix the property limits check

As reported by Coverity:

474      if (cmd >= DTV_USER_COMMAND_START && cmd <= DTV_MAX_STAT_COMMAND)
>>>     CID 1237264:  Out-of-bounds read  (OVERRUN)
>>>     Overrunning array "dvb_user_attr_names" of 13 8-byte elements at element index 260 (byte offset 2080) using index "cmd - 256" (which evaluates to 260).
475      return dvb_user_attr_names[cmd - DTV_USER_COMMAND_START];
476      return NULL;

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: make sure that all needed properties are filled

Sometimes, some DVB files don't have all properties. Instead of
not initializing them and causing latter problems, initialize
such vars with default values.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add support for PLS code/mode for file read/write

Those parameters are found on some DVB-S2 tables at the
dtv-scan-tables. Those aren't used by libdvbv5, but we need to
parse, in order to preserve those fields when reading/writing
files with the legacy format.

So, add partial support for them.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: MIS default should be zero

On DVB-S2, when MIS is not specified, that means that it should
be equal to zero. Fix it at the legacy import logic.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: use default values if an entry is missing

On optional properties, instead of generating an error, just
use the default value on writing.

Also fixes a bug where it goes past the end of the table, when
a property is not found.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: avoid checking past data

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Fix the error message when a props is not found

The acessed data when a property is not found on write
format oneline is wrong. Use dvb_cmd_name() to get the right
one, and uses the field that came from table->prop.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Add MIS to DVB-S2 properties

MIS is a property of DVB-S2 standard. Add it to the
list of the valid properties.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: better document dvb-v5-std.h

Reorganize the header to better document it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Split libdvbv5 properties from stats

As newer needs are added to the library, we want to be able
to add new commands and new stats independently.

So, we need to split the properties into two different ranges,
or otherwise a new libdvbv5 command property would break
userspace, by renumbering the statistics.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

qv4l2: fix bug in setting the audio mode

Instead of s_tuner it called g_tuner, and that doesn't work of course.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

libdvbv5: fix parsing of the default_value

The parameters were wrong filled. Fix it. While here, add some
parenthesis at the expressions that check for it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

Stop using the legacy name for PLP/MIS property

Use DTV_STREAM_ID instead of the legacy name.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Fix delivery system for channel on DVB-T2 format

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Add support for parsing DVB-T2 channel format

Some tables at dtv-scan-tables use T2 as a delimiter for
DVB-T2. Add support for it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add support for optional MIS parameter

Some files at dtv-scan-tables have some optional fields.
The first one is part of the DVBv5 API. It is called
Multistream (MIS), and it is mapped as DTV_STREAM_ID
at the DVBv5 API.

Add support for it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add support for optional parameters on oneline formats

Some oneline formats have optional parameters. Add support
for them.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: remove some commented dead code

There are some dead code at dvb-file.c. Remove them

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: only use emulated formats if the original one is not found

Now that we've added DVB-S2 scan-s2 format, we want that the
format conversion tool to be able to write to that format too.

So, instead of emulating DVB-S channels, write them using
the new format.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Fix modulation formats for legacy channel on DVB-S2

DVB scan-s2 format uses a different names from the ones originally
defined. Fix it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: don't write polarization and user parms twice

Currently, there are two loops printing user cmds. This is not
needed, and will just write duplicate values at the output.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add support for parsing scan-s2 DVB-S2 channels

This format also specifies rolloff and modulation. Add
support for it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Improve parsing of dvb channel format

Some channel files also use tabs as delimiter, like
dvb-c/ch-GGA-Pratteln

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

Copy the vivid-tpg* sources from the kernel

This keeps the test pattern generator in v4l-utils in sync with the
tpg in the vivid kernel driver.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

Add the generated lib/include/dvb-frontend.h to .gitignore

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

v4l-utils: sync-with-kernel

Update headers to the latest kernel version.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

v4l2-ctl/qv4l2: sync to latest vivid-tpg code

This updates vivid-tpg to the latest kernel version.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>

dvbv5-zap: close dvr_fd at the end of do_traffic_monitor()

As reported by Coverity:

685        close (fd);
CID 1054585 (#1-3 of 3): Resource leak (RESOURCE_LEAK)35. leaked_handle: Handle variable dvr_fd going out of scope leaks the handle.
686        return 0;
687}
688

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: add a missing return

Changeset 0097e30 fixed a Coverity bug that were causing a
memory leak in the case that the DVB dummy logic happens.
However, I forgot to add a return there, causing another
bug, also reported by Coverity:

*** CID 1233758:  Use after free  (USE_AFTER_FREE)
/lib/libdvbv5/descriptors.c: 81 in dvb_desc_default_print()
75     {
76      if (!parms) {
77      parms = dvb_fe_dummy();
78      dvb_hexdump(parms, "|           ", desc->data, desc->length);
79      free(parms);
80      }

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Allocate channel earlier

As reported by Coverity:

CID 1228897 (#1 of 1): Explicit null dereferenced (FORWARD_NULL)14. var_deref_model: Passing null pointer channel to get_program_and_store, which dereferences it. [show details]
1129                        rc = get_program_and_store(parms, *dvb_file, dvb_scan_handler,
1130                                                   service_id, channel, NULL,
1131                                                   get_detected, get_nit);

Well, get_program_and_store() explicitly tests if channel is null or
not, but it does it too late.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Fix changeset 04accf23

The check for the array size is wrong. Fix it.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>

libdvbv5: Don't go past the size of dvb_v5_attr_names

As reported by Coverity:

4. cond_between: Checking cmd < 256 implies that cmd has the value which is between 0 and 255 (inclusive) on the true branch.
469        if (cmd >= 0 && cmd < DTV_USER_COMMAND_START)

CID 1054610 (#1 of 1): Out-of-bounds read (OVERRUN)5. overrun-local: Overrunning array dvb_v5_attr_names of 70 8-byte elements at element index 255 (byte offset 2040) using index cmd (which evaluates to 255).
470                return dvb_v5_attr_names[cmd];
471        else if (cmd >= 0 && cmd <= DTV_MAX_STAT_COMMAND)
472                return dvb_user_attr_names[cmd - DTV_USER_COMMAND_START];
473        return NULL;

This wouldn't be a problem if the function was just internal,
but this is part of the public functions.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>