timer: update documentation for system call information

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

hwdep: update documentation with system call information

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

ctl: update documentation with system call information

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

seq: user_client: correct ioctl command to get the usage of queue by client

Fixes: 4198dc4f7854 ("seq: user_client: add APIs to register usage of queue")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: user_client: correct ioctl command to update queue

Fixes: 2ab3feab20d3 ("seq: user_client: add APIs to create/delete/update queue")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: stream-pair: fix signal name according to internal convention

Fixes: bd91f8f3d6f2 ("rawmidi: stream_pair: add GObject signal to notify receipt of messages")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

rawmidi: fix leak of file descriptor in global methods of ALSARawmidi

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

hwdep: fix leak of file descriptor in global methods of ALSAHwdep

Fixes: 53d99ede2486 ("hwdep: add global method to get information of hwdep device")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add API to choose the type of event to read

Currently ALSATimer.UserInstance has any attach API to decide the type of
event to read. In design of ALSA Timer core, the attach API has two
functionality; to attach or to detach with error for absent timer device.
Current implementation has inconvenient for the functionality due to
execution to choose the type of event in advance. The execution fails
when the instance is already attached.

This commit adds a new API to choose the type of event and split the
call from any attach API.

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

ctl: elem_info: fix SIGSEGV due to missing sentinel for arguments of g_object_new()

Fixes: 5cc31d27e702 ("ctl: elem_info: become concrete class instead of abstract class")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_info_int64: dismiss ALSACtlElemInfoInt64

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

ctl: elem_info_iec60958: dismiss ALSACtlElemInfoIec60958

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

ctl: elem_info_bytes: dismiss ALSACtlElemInfoBytes

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

ctl: elem_info_enum: dismiss ALSACtlElemInfoEnum

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

ctl: elem_info_int: dismiss ALSACtlElemInfoInt

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

ctl: elem_info_bool: dismiss ALSACtlElemInfoBool

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

ctl: elem_info: become concrete class instead of abstract class

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

ctl: elem_info: add count property

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

ctl: elem_info: add accessor APIs for label entries of enumerated element

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

ctl: elem_info: add accessor APIs for triplet data of integer64 element

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

ctl: elem_info: add accessor APIs for triplet data of integer element

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

ctl: card: add helper function to parse names for enumerated element

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

ctl: card: fix uninitialized local value

Fixes: eace1901a13e ("ctl: card: add an API to add/replace user-defined elements")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

doc: ctl: fix title for documentation of ALSACtlElemInfo

Fixes: cc7a8b2fe1459 ("ctl: fulfill documentation for ALSACtl")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

doc: hwdep: fix invalid element name

Fixes: eb03ec0340bc ("hwdep: fulfill documentation for ALSAHwdep")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_status: use shorter name for timestamp

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

timer: ALSATimerEventDataType: use shorter name for timestamp

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

timer: event: add documentation for ALSATimerEvent

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

timer: event: add accessor methods for tick and tstamp events

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

timer: event_data: dismiss ALSATimerEventData

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

timer: event_data_tstamp: add accessor APIs for tstamp event

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

timer: event_data_tstamp: rename to ALSASeqEventDataTstamp

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

timer: event_data_timestamp: become boxed object

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

timer: event_data_tick: add accessor APIs for resolution and tick count

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

timer: event_data_tick: become boxed object

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

timer: user_instance: emit signal with ALSATimerEvent

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

timer: add boxed object to represent union of two timer events

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

seq: queue_timer_alsa: obsolete ALSASeqQueueTimerAlsa

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

seq: queue_timer: define as concrete class instead of abstract class

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

seq: queue_timer: add accessor APIs for data of queue timer in ALSATimer case

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

seq: queue_timer: make properties read-only

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

seq: queue_timer_data_alsa: add documentation

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

seq: queue_timer_data_alsa: add accessor APIs for resolution

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

seq: queue_timer_data_alsa: add accessor APIs for device ID of ALSATimer

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

seq: queue_timer_data_alsa: add boxed object to represent data of queue timer in ALSATimer case

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

seq: scan ALSATimer-0.0 gir by g-ir-scanner for dependency

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

tests: fix a test for ALSASeqQueueTimer

Fixes: 4018fe02a4ea ("seq: queue_timer: add abstract object to represent timer attached to queue")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: fix segmentation fault due to uninitialized value

Fixes: 940885e0982b ("seq: add global method to get list of numerical ID of queue")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add global method to retrieve current source of timestamp

doc: hwdep: fix missing content of introduction element

Fixes: eb03ec0340b ("hwdep: fulfill documentation for ALSAHwdep")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: event: dismiss ALSASeqEvent

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

seq: event_fixed: dismiss ALSASeqEventFixed

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

seq: event_variable: dismiss ALSASeqEventVariable

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

seq: user_client: schedule events in ALSASeqEventCntr instead of ALSASeqEvent

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

seq: user_client: emit ALSASeqEventCntr instead of ALSASeqEventFixed/ALSASeqEventVariable

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

seq: user_client: use ALSASeqEventCntr to parse read data

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

doc: seq: add documentation for ALSASeqEventCntr

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

seq: event_cntr: add accesor APIs for result data of event pointed by index

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

seq: event_cntr: add accesor APIs for connect data of event pointed by index

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

seq: event_cntr: add accesor APIs for address data of event pointed by index

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

seq: event_cntr: add accesor APIs for timestamp data of event pointed by index

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

seq: event_cntr: add accesor APIs for queue data of event pointed by index

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

seq: event_cntr: add accesor APIs for blob data of event pointed by index

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

seq: event_cntr: add accesor APIs for quadlet data of event pointed by index

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

seq: event_cntr: add accesor APIs for byte data of event pointed by index

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

seq: event_cntr: add accesor APIs for control data of event pointed by index

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

seq: event_cntr: add accesor APIs for note data of event pointed by index

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

seq: event_cntr: add accesor APIs for the destination/source of event pointed by index

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

seq: event_cntr: add accesor APIs for the tstamp of event pointed by index

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

seq: event_cntr: add accesor APIs for the numerical ID of queue to deliver the event pointed by index

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

seq: event_cntr: add accesor APIs for the tag of event pointed by index

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

seq: event_cntr: add accesor APIs for the priority mode of event pointed by index

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

seq: event_cntr: add accesor APIs for the length mode of event pointed by index

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

seq: event_cntr: add accesor APIs for the time mode of event pointed by index

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

seq: event_cntr: add accesor APIs for the timestamping mode of event pointed by index

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

seq: event_cntr: add accesor APIs for the type of event pointed by index

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

seq: event_cntr: add an API to calculate the amount of cells in pool consumed by a batch of event

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

seq: event_cntr: add an API to calculate the number of events

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

seq: add private structure and constructor

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

tests: add a test for ALSASeqEventCntr

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

seq: event_cntr: add GObject-derived object to represent container for a batch of events

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

seq: client_pool: update descriptions of properties

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

seq: fulfill documentation for ALSASeq

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

rawmidi; fulfill documentation for ALSARawmidi

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

timer: fulfill documentation for ALSATimer

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

hwdep: fulfill documentation for ALSAHwdep

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

ctl: improve documentation for ALSACtl

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

ctl: fulfill documentation for ALSACtl

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

seq: user_client: remove useless argument of delete_port()

In implementation of ALSA sequencer core, the port owned by client can
be deleted by userspace applications which opens the client, therefore
it's necessary and sufficient to have an argument just for the numerical
ID of port.

This commit removes the useless argument for port information.

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

seq: user_client: use constant qualifier for read-only parameter

The 'port_id' parameters of 'alsaseq_user_client_create_port()' is
a pointer to storage of unsigned char type, due to optional parameter
in g-i interface. It's read-only if having value and it's better to
have const qualifier.

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

Revert "seq: tstamp: use wrapper structure instead of union"

This reverts commit 20fdc2d893ccba609cc786ebac733bf6914f9874.

In the above commit, union type structure is wrapped with care of
language bindings in which union-compatible feature is not expected.
However, it's responsible for language bindings to parse gir and
the care is not necessarily required in shared library side. In first
place, ALSASeq.Tstamp is boxed type object.

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

seq: addr: add API to compare two instances

It's convenient to compare two instances of address in ALSA Sequencer.

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

seq: event_data_queue/event_fixed: improve annotations for quadlets methods

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

seq: event_data_queue/event_fixed: improve annotation for byte methods

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

seq: event_data_queue/queue_tempo: improve annotation for skew methods

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

seq: event_fixed: use 'not a variable length array type' for quadlets argument

The type of quadlets argument is fixed-sized array.

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

seq: event_data_queue: use 'not a variable length array type' for quadlets argument

The type of quadlets argument is fixed-sized array.

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

seq: event_fixed: use 'not a variable length array type' for bytes argument

The bytes argument is fixed-sized array.

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

seq: event_data_queue: use 'not a variable length array type' for bytes argument

The type of bytes argument is fixed-sized array.

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

seq: queue_tempo: use 'not a variable length array type' for skew argument

The type of skew argument is fixed-sized array.

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