NAME

cape_utils - A utility to help with various basic tasks related to CAPEv2.

VERSION

0.1.0

SYNOPSIS

cape_utils -a submit [-c <config>] [--clock <time>] [--timeout <seconds>] [--machine <machine>] [--package <package>] [--options <options>] [--tags <tags>] [--enforce_timeout] [--unique] [--json] [--quiet] <file/dir> [<file/dir...]

cape_utils -a running [-c <config>] [-C] [-w <where>] [--json]

cape_utils -a pending [-c <config>] [-C] [-w <where>] [--json]

cape_utils -a tasks [-c <config>] [-C] [-w <where>] [--direction <dir>] [--order <column>] [--json]

cape_utils -a fail [-c <config>] -w <where>

cape_utils -a eve [-c <config>]=head1 Action: submit

cape_utils -a munge [-c <config>] -r <report json>

GENERAL FLAGS

--c <ini>

Config INI file.

Default: /usr/local/etc/cape_utils.ini

-a <action>

Action to perform.

---json

Output the result of searches or submissions as JSON.

ACTIONS

submit

@ARGS

Files/dirs to submit.

--clock <time>

Timestamp to use for setting the clock to of the VM for when executing the item. If left undefined, it will be autogenerated.

Format :: mm-dd-yyy HH:MM:ss

--timeout <timeout

Timeout value in seconds.

Default :: 200

--machine <machine>

The machine to use for this. If not defined, first available will be used.

Default :: undef

--package <package>

Package to use, if not letting CAPE decide.

Default :: undef

--options <opts>

Option string to be passed via --options.

Default :: undef

--tags <tags>

Tags to be passed to the script via --tags.

Default :: undef

--enforce_timeout

Force it to run the entire period.

--unique

Only submit unique items.

--quiet

Do not print the output from the submission command.

running

-C

Print the running count instead of the table.

-w <where>

Additional SQL args for use with statement for getting running items.

pending

-C

Print the pending count instead of the table.

-w <where>

Additional SQL args for use with statement for getting pending items.

tasks

-C

Print the running count instead of the table.

--direction <dir>

Direction to order in, desc or asc.

Default :: desc

--order <column>

Column to order by.

Default :: id

-w <where>

Additional SQL args for use with statement for getting running items.

fail

-w <where>

Additional SQL args for use with statement for failing pending items.

eve

Invoke CAPE::Utils->process_eve.

munge

-r <report json>

The report JSON to munge.

CONFIG FILE

For this, see the docs for CAPE::Utils.

Out of the box, it will work by default with CAPEv2 in it's default config.