rawmidi; stream_pair: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: query: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: enums: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep: device_info: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep: query: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_value: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_info: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_id: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: card_info: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: card: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: query: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: enums: link optimization to gi-docgen

The gi-docgen supports enhancement of inter-document link. This commit is
optimization to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep/rawmidi: enums: rename enumerators with enumerations

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

markup URI correctly in README

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

Split dependency section with requirements section in README

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

fix installation path for documents in README

Fixes: 7a2e93e6f4a1 ("ctl: migrate to gi-docgen from gtk-doc")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: fix wrong handling of open flag

ALSARawmidi.StreamPair.open() has open_flag parameter for flags parameter of
open(2) system call, however internally it's not handled correctly.

This commit fixes the bug.

Fixes: 909ff54d5265 ("rawmidi: stream_pair: add APIs to open ALSA Rawmidi character device")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: queue_timer: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: queue_tempo: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: queue_status: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: queue_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: event_cntr: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: subscribe_data: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: port_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: system_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: client_pool: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: client_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: user_client: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_params: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_status: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_params: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_status: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: substream_status: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi; substream_params: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: substream_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: stream_pair: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep: device_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_value: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: card_info: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: card: use an utility macro to declare GObject-derived object

Since gobject v2.44, an utility macro is available to declare
GObject-derived objects.

This commit replaces existent boireplates with it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_params: fix type decration with private data

Fixes: 20cb2a1f111 ("timer: device_params: add properties")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: enum: fix tab indentation

Fixes: 9a3d1477403b ("seq: user_client: report error for port access permission")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

all: minor code refactoring for inclusion guard

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

utils: add utility macros to generate GError with file domain

It's convenient to add macro to generate GError with file domain since
failure of operation over sysfs is reported in the domain.

This commit adds such macro.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

utils: add utilities to request control ioctl

In ALSA HwDep and RawMidi interface, some functions are implemented via
ALSA control character device.

This commit adds utility to perform ioctl in ALSA control character device
for the purpose.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

utils: add utilitiy to generate list of sysnum by prefix of sysname

It's typically used to generate the list of sysnum over sysfs by sysname
prefix.

This commit adds utility for it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

utils: add utilities to allocate string information for device

It's typically used to look for string information over sysfs according to
sysname.

This commit adds utilities for it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

utils: add utility to compute integer value from string literal

The conversion between string literal and integer is required in some
includes libraries.

This commit adds utility for it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

utils: build internal static library including common utilities

Current implementation of included libraries includes duplicated codes
to operate over sysfs by libudev. It's inconvenient in a point of
maintenance.

This commit adds internal static library for such duplicate codes.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: move path to top header to metadata part

This commit refactors configuration related to top header for preprocessor
to reduce difference of each meson configuration.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: aggregate and move extra gir to metadata part

This commit refactors duplicated entries for depended gir name to reduce
difference of each meson configuration.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: move pkg-config description to metadata part

This commit refactors description for pkg-config to reduce difference of
each meson configuration.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: fulfil missing sources for gir scanner which are blank

This commit refactors the list of sources for gir scanner to reduce
difference of each meson configuration.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: aggregate module imports

This commit refactors to unify common module imports.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: aggregate dependency declaration on glib/gobject and libudev

All of included libraries depend on glib, gobject, and libudev. It's
possible to aggregate declaration of the dependency.

This commit refactors according to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: code refactoring for search path of alsatimer header

Current implementation uses several entries for include_directories
parameter of library function. It's possible to replace it by using
include_directories parameter of declare_dependency function.

This commit refactors meson configuration for alsatimer library according
to it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: fix unintended line break for identifier

Fixes: ac7c096dae15 ("meson: code refactoring to remove useless assignments for include headers")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: fix argument names with suffix '_id'

According to the convention in this project.

Fixes: 55f796b5ad33 ("rawmidi: add global method to get list of directional subdevices for rawmidi device")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

doc: install HTML file for index page

This commit adds HTML file for index page.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: migrate to gi-docgen from gtk-doc

This commit uses gi-docgen and obsolete gtk-doc.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: migrate to gi-docgen from gtk-doc

This commit uses gi-docgen and obsolete gtk-doc.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: migrate to gi-docgen from gtk-doc

This commit uses gi-docgen and obsolete gtk-doc.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep: migrate to gi-docgen from gtk-doc

This commit uses gi-docgen and obsolete gtk-doc.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: migrate to gi-docgen from gtk-doc

This commit uses gi-docgen and obsolete gtk-doc.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: minor code refactoring for option of documentation

This commit arranges subdirectory inclusion for documentation.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ci: update build environment to use gi-docgen

The new dependency on gi-docgen needs specific packages in CI environment.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: rename gtk_doc option

The new dependency of gi-docgen obsoletes usage of gtk-doc, therefore it
is better to rename option for meson configuration.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ci: remove outdated actions

This commit removes useless entries for workflow in github actions.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: add entry header to aggregate header inclusion

It's convenient to add header to include all of headers in regard of
documentation.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add entry header to aggregate header inclusion

It's convenient to add header to include all of headers in regard of
documentation.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: add entry header to aggregate header inclusion

It's convenient to add header to include all of headers in regard of
documentation.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep: add entry header to aggregate header inclusion

It's convenient to add header to include all of headers in regard of
documentation.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: add entry header to aggregate header inclusion

It's convenient to add header to include all of headers in regard of
documentation.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: code refactoring to remove useless assignments for include headers

In meson build, gnome.mkenums_simple() and gnome.genmarshal()
voluntarily install headers, therefore it's useless to install
them explicitly by install_headers().

This commit removes useless assignments for include headers. I note that
gnome.generate_gir() fails to parse codes when enums are prior to
headers and sources. This commit also reorder entries for safe.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: minor code refactoring for include directories

The path to include directory for installation is referred by several
parts. This commit adds local variable for it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: obsolete usage of deprecated meson.build_dir()

Meson build v0.56 deprecates meson.build_root(). This commit adds
alternative variable for the path to built stuffs.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

meson: infer library soname for .pc file

In meson build, the pkgconfig module automatically infers soname from
given object. Let's use it.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

bump version up to 0.2.2 for maintenance release

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: fix misfunction of alsactl_get_card_id_list()

Even if instantiation of libudev enumerator is successful,
alsactl_get_card_id_list() handles the success as failure. As a result,
the function does not work at all.

This commit fixes the bug.

Fixes: bfe4b0589fc6 ("ctl/hwdep/rawmidi: fix uninitialized warning")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl/timer/seq: optimization for GLib v2.68

The usage of g_memdup() is deprecated since glib 2.68 because it has
narrow integer conversion from gsize to guint.

This commit replaces the usage with macro for g_memdup2().

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl/hwdep/rawmidi: fix uninitialized warning

This commit fixes uninitialized warnings.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

bump version up to 0.2.1 for maintenance release

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: use safer way to copy strings

The call of strncpy can results in destination buffer without null as
terminator in the case of truncation. Compiler reports the risk as
warnings, like:

In function ‘strncpy’,
    inlined from ‘alsaseq_get_queue_info_by_name’ at ../src/seq/query.c:670:5:
/usr/include/x86_64-linux-gnu/bits/string_fortified.h:95:10: warning: ‘strncpy’ specified bound 64 equals destination size [-Wstringop-truncation]
   95 |   return __builtin___strncpy_chk (__dest, __src, __len,
      |          ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   96 |       __glibc_objsize (__dest));
      |       ~~~~~~~~~~~~~~~~~~~~~~~~~

This commit uses safer way to copy strings, g_strlcpy(), to fix the bug.

Fixes: 4e8675f631ce ("seq: client_info: add properties and accessor methods")
Fixes: f3457eaf706b ("seq: port_info: add properties")
Fixes: 1eabdf6bc647 ("seq: add global method to get the information of queue")
Fixes: f26342b3ab3d ("seq: queue_info: add properties and constructors")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl/rawmidi/hwdep: fix compiler warning due to uninitialized variables

In some libraries, the local variable of udev enumerate is carelessly
uninitialized. As a result, compiler generates warnings, like:

../src/ctl/query.c: In function ‘alsactl_get_card_id_list’:
../src/ctl/query.c:131:8: warning: ‘enumerator’ may be used uninitialized in this function [-Wmaybe-uninitialized]
  131 |     if (enumerator == NULL)
      |        ^

This commit fixes the bug.

Fixes: d1936fbbe7e2 ("ctl: add global method to get list of available sound cards")
Fixes: cb128c5b59e0 ("rawmidi; add global method to get list of rawmidi device for sound card")
Fixes: d4a9f6735d05 ("hwdep: add global method to get list of hwdep devices in sound card")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: event_data_ctl: fix getter API for value parameter

ALSASeq.EventDataCtl.get_value() is programmed carelessly to return
the value in parameter field instead of value field.

This commit fixes the bug.

Fixes: a8f603eff4f5 ("seq: event_data_ctl: add accessor methods")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

update Fedora release for CI environment

This commit update Fedora release up to 34.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

fix workflow according to EOF of i386 ubuntu distribution

Ubuntu 19.10/i386 is EOL and no release is available for i386 architecture
in Ubuntu project.

This commit removes job for i386 architecture from workflow of Github
Actions.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

correct install section in README

The command `meson build` is not correct.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

bump version up to 0.2.0 to release

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

upgrade CI operationg system to Fedora 33

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

upgrade CI operationg system to Ubuntu 20.04 LTS amd64

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep: fix metadata and documentation for the type of interface

The scanner of g-i and gtk-doc can't handle macro lines in enumeration
lines expectedly.

This commit fixes to generate valid metadata and documentation.

Fixes: 843c9fe68228 ("hwdep: conditional build for Linux kernel 4.12 or later")
Fixes: 45f650bf29e8 ("hwdep: conditional build for Linux kernel v4.9 or later")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep: conditional build for Linux kernel 4.12 or later

The type of interface in ALSA HwDep interface got a new entries in Linux
kernel v4.12.

This commit adds conditional macro to build for Linux kernel v4.12 or later.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

hwdep: conditional build for Linux kernel v4.9 or later

The type of interface in ALSA HwDep interface got a new entry in Linux
kernel v4.9.

This commit adds conditional macro to build for Linux kernel v4.9 or later.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: client_info: conditional build for Linux kernel v4.6 or later

Some members were added to snd_seq_client_info strucutre in Linux kernel
v4.6.

This commit adds conditional macro to build for Linux kernel v4.6 or later.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: query: fulfil comment about GError

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>