NAME

       irtestcase - Create or check decoding testcases.

SYNOPSIS

       irtestcase [-l lircrc-file -p prog] <socket>

       irtestcase [-l lircrc-file -p prog] -t testdata <socket>

       irtestcase [-v|-h]

DESCRIPTION

       irtestcase  is  a tool which can record keypresses from a remote together with the decoded
       values. Given output from another session, it can also  verify  that  the  decoding  still
       works as expected.

       In the first form irtestcase will wait for input and create log files for it. Doing so, it
       also echoes received buttons on stdout. There is no way to stop the  program  in  a  clean
       way, just use ctrl-C when completed.

       In  the  second form it will feed the data from the testdata file to lircd and log the the
       decoded data as usually. Thus, this makes it possible to test the output from  the  remote
       which generated the testdata.  In this form lircd must be running with the "file" driver.

       The  optional  socket  is  the lircd output socket (lircd must be running). It defaults to
       LIRC_SOCKET_PATH  in  environment,   falling   back   to   a   hardcoded   default   value
       (/var/run/lirc/lircd).

OPTIONS

       -l, --lircrc  <lircrc config file>
           Log also applications strings (as ircat(1)) using lircrc type config file.

       -p, --prog <program id>
           When using -l/--lircrc, the program name matching the PROG = entries in lircrc

       -t, --testdata
           Use data i file instead of "live" input from the remote. This can be the durations.log
           file from a previous run, see FILES. It can also be logged output from mode2(1).

       -v , --version
           Print version and exit.

       -h , --help
           Print help message.

ENVIRONMENT

       irtestcase respects LIRC_SOCKET_PATH which if defined holds the path to the  lircd  output
       socket to listen to.

FILES

       /tmp/irtestcase
           irtestcase creates files in /tmp/irtestcase (hardcoded, sorry). After a successful run
           here is:

           durations.log
               Printable space/pulse durations in the same  format  as  mode2(1).  This  file  is
               usable as -t/--testdata input.

           codes.log
               The decoded  buttons, in same format as irw(1).

           app_strings.log
               The application strings, as presented by ircat(1).

       ~/.cache/irtestcase.log
           Debug  log.  Setting  the  XDG_CACHE_HOME  environment variable relocates this file to
           $XDG_CACHE_HOME/irtestcase.log. The  amount  of  logging  respects  the  LIRC_LOGLEVEL
           environment  variable,  defaulting  to  the  debug  value  in  the  [lircd] section of
           lirc_options.conf.

SEE ALSO

       The documentation for lirc is maintained as html pages. They are located  under  html/  in
       the documentation directory.