NIJIKA(1)

2024-05-07

NAME

Nijika - definitely not the command player

SYNOPSIS

nijika [-v] [-P <time>] [-e <num>] [-i <id>] [-p <num>]

DESCRIPTION

Nijika is a tool to execute a list of commands specified through a file.

Nijika will read the file named "commands<id>.txt" placed in the current working directory. Within that file, one line equals one command/task. Those will be processed in order: commands at the top of the file are executed first. They will be executed in the current working directory. At the start of the execution, the command will be logged together with a timestamp into a file named "commandLog<id>.txt" placed in the current directory. If a command does not complete successfully, you'll also find an error message for this in the log file.

The options are as follows:

-0

Enable stdin passthrough. This is only valid if the maximum number of tasks to execute concurrently is 1 (see -p).

-1

Enable stdout passthrough.

-2

Enable stderr passthrough.

-e <num>

Set the number of tasks to execute before Nijika exits. This option defaults to 0 meaning that the number of tasks to execute is unlimited.

-i <id>

Set the id of this instance. This option defaults to "nijika". The id is used for determining the name of the log file as well as the input file containing the commands.

-P <time>

Set the number of seconds between checking for a new command. This option defaults to 10.

-p <num>

Set the maximum number of tasks to execute concurrently. This option defaults to 1.

-v

Print the version information and exit.

EXIT STATUS

Nijika exits with 0 on a successful shutdown, and with >0 if an error occurs.

AUTHORS

Created and maintained by Hannes Braun <hannes@hannesbraun.net>. Up-to-date sources can be found at https://git.sr.ht/~hannes/nijika. Bugs and patches can be submitted by email to ~hannes/public-inbox@lists.sr.ht.