--package package-name

Specifies the name of the current package, to be used by package post-installation and pre-removal scripts. System administrators installing binary formats for local use should probably ignore this option. When installing new formats, the --import action should be used instead.

--admindir directory

Specifies the administrative directory, when this is to be different from the default of /var/lib/binfmts .

--importdir directory

Specifies the directory from which packaged binary formats are imported, when this is to be different from the default of /usr/share/binfmts .

--test

Don't do anything, just demonstrate what would be done.

--help

Display some usage information.

--version

Display version information.

--install name path spec

Install a binary format identified by name with interpreter path into the database. After registration, this format will be used when the kernel tries to execute a file matching spec (see below). --install will attempt to enable this binary format in the kernel as well as adding it to its own database; see --enable below. You cannot install a format with any of the names ".", "..", "register", or "status", as these are used by the filesystem or the binfmt_misc module.

--remove name path

Remove the binary format identified by name with interpreter path from the database. This will also attempt to disable the binary format in the kernel; see --disable below.

--import [name]

Import a packaged format file called name , or import all format files currently on the system if no name is given. If name is not a full path, it is assumed to be a file in the import directory by default). See below for the required contents of these files. For packages, this is preferable to using the --install option, as a format file can be installed without needing to be available.

--display [name]

Display any information held in the database about the binary format identifier name , or about all known binary formats if no name is given. Also show whether displayed binary formats are enabled or disabled.

--enable [name]

Enable binary format name , or all known binary formats if no name is given, in the kernel, thus enabling direct execution of matching files. You must have binfmt_misc compiled into the kernel or loaded as a module for this to work.

--disable [name]

Disable binary format name , or all known binary formats if no name is given, in the kernel, thus disabling direct execution of matching files. You must have binfmt_misc compiled into the kernel or loaded as a module for this to work.

--magic byte-sequence

This matches all files with the magic number byte-sequence . Hexadecimal escapes may be included in the byte-sequence by preceding them with \x, for example for a linefeed. Remember to protect such escapes with quotes or an additional backslash to prevent their interpretation by the shell. Also see --offset and --mask .

--offset offset

This is the offset of the magic/mask in the file, counted in bytes. The default is 0. Only valid with --magic .

--mask byte-sequence

This mask will be logically-ANDed with the string to be checked against the magic number given with --magic . The default is all 0xff, i.e. no effect. Only valid with --magic .

--extension extension

This matches all files whose names end in Hexadecimal escapes are not recognized here. Extension matching is case-sensitive.

--detector path

If this option is used, a userspace detector program will be used to check whether the file is suitable for this interpreter. This may be used when the binary format is more complex than can be handled by the kernel's format specifications alone. The program should return an exit code of zero if the file is appropriate and non-zero otherwise.

A format file is a sequence of options, one per line, corresponding roughly to the options given to an --install command. Each option consists of a key, followed by whitespace, followed by a value.

The package option should be set to the current package. The interpreter option should be set to the path to the interpreter that will handle this binary format. The magic , offset , mask , extension , and detector options correspond to the command-line options of the same names.