seq: user_client: add APIs to create/delete/update queue

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

seq: add global method to get the information of queue

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

seq: queue_info: add properties and constructors

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

seq: queue_info: add object to represent information of queue

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

seq: add global method to get list of numerical ID of queue

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

seq: add enumerations related to queue operation

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

seq: user_client: move header includsion for subclass of ALSASeqEvent

Fixes: 9d535a87381c: ("seq: user_client: add an API to schedule event")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: ensure to remove 'transfer full' annoation from constructors

Fixes: 4277625a6bb1: ("ctl remove 'transfer full' annoation from constructors")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl remove 'transfer full' annoation from constructors

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

timer: remove 'transfer full' annoation from constructors

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

seq: remove 'transfer full' annoation from constructors

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

ctl: elem_info_int: fix function annotation for constructor

Fixes: aac870451a89 ("ctl: elem_info_int: add properties for type-dependent parameters and constructor")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: event_data_result: change function signature to return nothing

The alsa-gobject project has a loose convention to have functions
returning nothing.

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

seq: event_data_note: change function signature to return nothing

The alsa-gobject project has a loose convention to have functions
returning nothing.

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

seq: event_data_ctl: change function signature to return nothing

The alsa-gobject project has a loose convention to have functions
returning nothing.

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

seq: event_data_queue: change function signature to return nothing

The alsa-gobject project has a loose convention to have functions
returning nothing.

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

seq: event_data_connect: change function signature to return nothing

The alsa-gobject project has a loose convention to have functions
returning nothing.

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

seq: event_fixed: change function signature to return nothing

The alsa-gobject project has a loose convention to have functions
returning nothing.

Fixes: 641f317f04b3 ("seq: event_fixed: add API to refer to byte data of event")
Fixes: 1b71f2015d06: ("seq: event_fixed: add API to refer to quadlet data of event")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: tstamp: change function signature to return nothing

The alsa-gobject project has a loose convention to have functions
returning nothing.

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

seq: event_fixed: change parameter names for byte and quadlet data

The getter/setter for byte and quadlet data has argument named as 'data'.
For this case, the alsa-gobject project has a loose convention to name them
as 'bytes' and 'quadlets'. This commit renames the arguments.

Fixes: 641f317f04b3 ("seq: event_fixed: add API to refer to byte data of event")
Fixes: 1b71f2015d06: ("seq: event_fixed: add API to refer to quadlet data of event")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: fulfill missing public symbol

The symbols of 'alsaseq_event_data_queue_get_byte_param' and
'alsaseq_event_data_queue_set_byte_param' is missing from the map of
public symbols.

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

seq: event_data_queue: fix type of argument for getter of byte param

Although the getter of byte param has argument of guint32 type, the
argument should be guint8 type.

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

update README

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

seq: doc: generate documentation for alsaseq library

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

seq: user_client: add an API to operate subscription between two ports

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

seq: add global method to get the list of subscriptions between ports

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

seq: subscribe_data: add properties

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

seq: subscribe_data: add object to represent subscription between two ports

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

seq: event_fixed: add a property for tstamp data of event

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

seq: event_fixed: add API to refer to quadlet data of event

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

seq: event_fixed: add API to refer to byte data of event

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

seq: event_fixed: add API to refer to data of connect type

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

seq: event_data_connect: add accessor methods

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

seq: event_data_connect: add Boxed object for data of connect type

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

seq: event_fixed: add a property for addr data of event

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

seq: event_fixed: add a property for queue data of event

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

seq: event_data_queue: add accessor methods

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

seq: event_data_queue: add Boxed object for data of queue control type

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

seq: event_fixed: add a property for ctl data of event

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

seq: event_data_ctl: add accessor methods

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

seq: event_data_ctl: add Boxed object for event of ctl type

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

seq: event_fixed: add a property for note data of event

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

seq: event_data_note: add accessor methods

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

seq: event_data_note: add Boxed object for event of note type

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

seq: event_fixed: add a property for result data of event

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

seq: event_data_result: add accessor methods

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

seq: event_data_result: add Boxed object for event of result type

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

seq: user_client: emit 'handle_event' signal

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

seq: user_client: add virtual method to handle event

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

seq: user_client: add GObject signal to handle event

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

seq: user_client: add an API to create GSource

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

seq: user_client: add an API to schedule event

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

seq: event_variable: add accessor methods and constructor

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

seq: event_variable: add GObject object for event with variable length data

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

seq: event_fixed: add constructor

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

seq: event_fixed: add GObject object for event with fixed length data

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

seq: event: add properties and access methods

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

seq: event: add GObject abstract object to represent event in ALSA Sequencer

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

seq: tstamp: add accessor methods

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

seq: tstamp: add Boxed object for timestamp union

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

seq: user_client: add APIs to set/get memory pool in client

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

seq: add global method to get information of memory pool for any client

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

seq: client_pool: add properties

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

seq: client_pool: add object to represent memory pool in client

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

seq: user_client: add APIs to create/delete port for client

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

seq: add global method to get information of port in client

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

seq: port_info: add properties

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

seq: port_info: add object to represent information of port for ALSA Sequencer

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

seq: addr: add accessor methods and constructors

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

seq: addr: add object to represent address in ALSA Sequencer

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

seq: add global method to get the list of port ID of client

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

seq: user_client: add APIs to set/get information as client for ALSA Sequencer

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

seq: user_client: add properties

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

seq: user_client: add an API to open ALSA Sequencer character device

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

seq: user_client: add object to represent user client for ALSA Sequencer

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

seq: add global method to get information of client for ALSA Sequencer

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

seq: client_info: add properties and accessor methods

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

seq: client_info: add object to represent information of client

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

seq: add global method to get list of client ID in ALSA Sequencer

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

seq: add global method to get information of ALSA Sequencer

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

seq: system_info: add properties

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

seq: system_info: add object to represent information of ALSA sequencer

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

seq: add global method to get devnode string for ALSA Sequencer

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

seq: add global method to get sysname for ALSA sequencer

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

seq: add Quark object to report any error

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

seq: tests: add test script for enumerations of ALSASeq

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

seq: generate enumerations

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

seq: generate alsaseq library

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

add support for i386 build job to workflow of Github Actions

In lxd repository for Ubuntu Cloud Images[1], Ubuntu i386 container
is available for applications of Intel386 ABI.

This commit uses the container to test build for Intel386 ABI in
workflow of Github Actions.

I note that no official Fedora i386 container is in dockerhub
registry[2]. It's needed to find the way to build application for
Intel386 ABI on AMD64 architecture (perhaps multiarch) if we are
going to support it.

[1] https://cloud-images.ubuntu.com/releases/
[2] https://hub.docker.com/_/fedora

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

timer: user-instance: delegate decision of poll timeout into application

As long as using the created Gsource with GMainContext, the call of poll(2)
system call with infinite timeout surely returns when quit() method is
called for the context. All of GMainContext implements GWakeup with eventfd
and the call of quit() emits event via file descriptor of eventfd. This
brings wakeup from blocking when poll(2) is called with inifinite timeout.

This means that it's necessarily need to have explicit timeout internally.
This commit removes implementation of GSourceFunc.prepare for the reason.

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

ctl: card: delegate decision of poll timeout into application

As long as using the created Gsource with GMainContext, the call of poll(2)
system call with infinite timeout surely returns when quit() method is
called for the context. All of GMainContext implements GWakeup with eventfd
and the call of quit() emits event via file descriptor of eventfd. This
brings wakeup from blocking when poll(2) is called with inifinite timeout.

This means that it's necessarily need to have explicit timeout internally.
This commit removes implementation of GSourceFunc.prepare for the reason.

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

timer: user-instance: add an argument for open(2) flag into API to open ALSA timer character device

As long as using the created Gsource with GMainContext, the call of poll(2)
system call with infinite timeout surely returns when quit() method is
called for the context. All of GMainContext implements GWakeup with eventfd
and the call of quit() emits event via file descriptor of eventfd. This
brings wakeup from blocking when poll(2) is called with inifinite timeout.
This means that it's safe for event polling without O_NONBLOCK.

On the other hand, there are many options for file descriptors; e.g.
O_APPEND and O_CLOEXEC. For the case, glib framework has no support.

This commit adds an argument for the open flags.

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

ctl: card: add an argument for open(2) flag into API to open ALSA control character device

As long as using the created Gsource with GMainContext, the call of poll(2)
system call with infinite timeout surely returns when quit() method is
called for the context. All of GMainContext implements GWakeup with eventfd
and the call of quit() emits event via file descriptor of eventfd. This
brings wakeup from blocking when poll(2) is called with inifinite timeout.
This means that it's safe for event polling without O_NONBLOCK.

On the other hand, there are many options for file descriptors; e.g.
O_APPEND and O_CLOEXEC. For the case, glib framework has no support.

This commit adds an argument for the open flags.

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

update README

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

timer: doc: generate documentation

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

timer: user_instance: add APIs to pause/continue event emission

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

timer: user_instance: add an API to stop event emission

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

timer: user_instance: add an API to start instance for timer device

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

timer: user_instance: emit 'handle_disconnection' GObject signal

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

timer: user_instance: add class virtual method to handle disconnection of the attached timer device

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