1. kathara-exec(1)
  2. Kathara manual
  3. kathara-exec(1)

NAME

kathara-exec - Execute a command in a Kathara device

SYNOPSIS

kathara exec [-h] [-d DIRECTORY | -v]
[--no-stdout] [--no-stderr] [--wait]
DEVICE_NAME COMMAND [COMMAND ...]

DESCRIPTION

Execute a command in the Kathara device DEVICE_NAME.

OPTIONS

-h, --help
Show a help message and exit.
-d DIRECTORY, --directory DIRECTORY
Specify the folder containing the network scenario.

Execute the specified command in a Kathara device belonging to a network scenario that is located inside DIRECTORY.
If no -d option is provided, assume the network scenario is located in the current directory. This option cannot be used in conjuction with -v or --vmachine.

-v, --vmachine
The device has been started with vstart command.

This option cannot be used in conjuction with -d or --directory.

--no-stdout
Disable stdout of the executed command.
--no-stderr
Disable stderr of the executed command.
--wait
Wait until startup commands execution finishes.

You can override the wait by pressing [ENTER].

`DEVICE_NAME
Name of the device to execute the command into.
`COMMAND
Shell command that will be executed inside the device.

EXAMPLES

kathara exec -v pc1 -- ping 127.0.0.1

Execute the command ping into a device called pc1, started with kathara-vstart(1).

kathara exec as1r1 "ping 127.0.0.1"

Execute the command ping into a device called as1r1 belonging to a network scenario located in current folder and started with kathara-lstart(1).

REPORTING BUGS

Report bugs opening an issue on the official GitHub repository where the development and maintenance is primarily done.
Issues which are security relevant should be disclosed privately to the Kathara mailing list. You do not have to be subscribed to the list to send a message there.
When reporting a bug, remember to write used commands, eventually attach your network scenario, and include the output of kathara-check(1) in order to make possible to reproduce the bug.

AUTHORS

Kathara was born from Netkit. Its first version was developed by Gaetano Bonofiglio and Veronica Iovinella. Currently it is mantained by Mariano Scazzariello, Tommaso Caiazzi and Lorenzo Ariemma.

People involved also include:

Copyright © 2017-2024 License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

kathara(1), kathara-vstart(1), kathara-lstart(1)

  1. February 2024
  2. kathara-exec(1)