Display default fossology agents or upload id’s and schedule default fossology agents on an upload id.

fossjobs [-a] [-h] [-u] [-v] [-A string] [-U upload-id] [-P priority]

fossjobs is a command line fossology utility that can be used to list the available default agents or upload id’s. Using that information, fossjobs can be used to schedule all the default agents or a subset of them for a given upload id. This effectivly creates a job and schedules the agents to perform their analysis on the upload id given.

Additionally, the priority can be set for that upload id/job. The agents will run at the priority set, or 0 if none supplied (the default).

• -h. Standard help flag, prints usage.
• -a. List the available default agents.
• -A string. This option can be used to run a subset of the default agents. The subset is specified using a comma separated list of agents. To display the available agents, use -a. Without this option, all default agents are scheduled.
• -u. List the available upload id’s.
• -U upload-id. The upload id to schedule the agents to work on. To find an upload id use -u. The upload-id string can be a comma-separated list of upload ids. Or, use ‘ALL’ to specify all upload ids.
• -P priority. The priority for the job/agents. Priorities are integers and can be negative or positive. The default priority is zero (0). (Generally they are kept in the range of -10 to 10, but any integer is acceptable.) Jobs will not run until all higher priority jobs that can run are processed.
• -v. Verbose output.

List all of the available agents:

fossjobs -a

List the upload id’s:

fossjobs -u

Schedule a subset of the agents (unpack and license) on an upload id:

fossjobs -A "agent_unpack,agent_license" -U 20

Schedule all the agents using a priority of 5 on upload id 20:

fossjobs -U 20 -P 5

Schedule all upload id’s with all default agents:

fossjobs -U ALL

Neal Krawetz and Mark Donohoe