OS4X plugin os4xplugin zip decompress

From OS4X
Jump to navigation Jump to search


== Purpose ==Tests each individual file in the job to see whether it is a ZIP compressed file. If successful, the file is decompressed, the target path corresponds to the position of the file (i.e. any directory structures are also stored there). The ZIP file itself is removed from the job after successful decompression (logically, not physically).

Requirements

  • File /etc/os4x.conf or configuration file referenced by environment variable $OS4X_CFGFILE. The temporary directory and the license file are obtained via the database that is configured here.

Configuration

  • extractOnlyZip: If this boolean configuration value is activated, only files with the extension ".zip" will be decompressed. This makes it easier to handle ZIP archives that are not apparent as such, such as JAR, docx, pptx, xlsx or similar file formats.

The program "unzip" is searched for in the PATH of the shell under which the plugin is started. This means that the unzip version used can be influenced by clever positioning or definition of the default PATH.

Return codes

  • 0: everything OK
  • 1: Number of parameters != 1; Config file /etc/os4x.conf not found; Config in database not readable; License not valid; XML file invalid