lkstm(8)

NAME
lkstm - Control maskset in LKST.

SYNOPSIS
lkstm command [ option(s) ]

DESCRIPTION
This command controls maskset in LKST, such as reading, writing, deletion, changing, and displaying list of all masksets.

COMMANDS

all Output a list of masksets and display content of all masksets.

delete/del -m maskset_id | -n maskset_name
    Delete a maskset.

-m maskset_id
    Specify the id of a maskset to delete.

-n maskset_name
    Specify the name of a maskset to delete.

list/ls
    Output a list of all masksets.

read [-m maskset_id | -n maskset_name] [-A] [-a] [-d]
    Output the contents of a maskset.

-m maskset_id
    Specify the id of a maskset to read.

-n maskset_name
    Specify the name of a maskset to read. If both maskset_id and maskset_name are omitted, read the currently selected maskset.

-A  Read all masksets.

-a  Do not omit not registered event type. It ignored if "-d" option is specified.

-d  Do not display a description of each event type.

set -m maskset_id | -n maskset_name
    Change currently selected maskset.

-m maskset_id
    Specify the id of a maskset to select.

-n maskset_name
    Specify the name of a maskset to select.

write [-m maskset_id] [-f file_name] [-n maskset_name] [-S]
    Write a new maskset.

-m maskset_id
    Specify the id of a maskset to write. If omitted, unused id is selected automatically.

-f file_name
    Specify a file which the content of the maskset is written. If ommited, standard input is used as input. This file can be created by "read" command as template.

-n maskset_name
    Specify the name of new maskset. If omitted, the name of new maskset is set as "new_maskset0". When it is already used, change to "new_maskset1". And when it is used too, change to "new_maskset2", and so on (IOW, this increments tag number.)

-S  Change the currently selected maskset to the written maskset.

find -n maskset_name
    find the id of a maskset from its name.

-n maskset_name
    Specify the name of a maskset to find.

NOTE:
    If no maskset has maskset_name, then outputs 255 (=LKST_MASKSET_ID_VOID).

config/conf [-m maskset_id | -n maskset_name] <event_type> <event-handler_id>
    Config a maskset.

-m maskset_id
    Specify the id of a maskset to configure.

-n maskset_name
    Specify the name of a maskset to configure. If both of id and name are omitted, currently selected maskset is configured.

event_type
    Specify the type of an event to change.

event-handler_id
    Specify the id of an event-handler to change to.

version/ver
    Print version of this command.

help
    Print help message.

RETURN VALUE

0   success

Except 0
    failure

REFERENCES
lkst(8), ioctl(LKST_IOC_MASKSET_READ)(2), ioctl(LKST_IOC_MASKSET_WRITE)(2), ioctl(LKST_IOC_MASKSET_LIST)(2), ioctl(LKST_IOC_MASKSET_SET)(2), ioctl(LKST_IOC_MASKSET_DELETE)(2)