8				     LOCAL				     8

NAME
     binmiscctl -- manage binary image activators

SYNOPSIS
     binmiscctl add name --interpreter path --magic magic --size size
		[--mask mask] [--offset offset] [--set-enabled]
     binmiscctl remove name
     binmiscctl disable name
     binmiscctl enable name
     binmiscctl lookup name
     binmiscctl list

DESCRIPTION
     The binmiscctl utility is the management utility for configuring miscel-
     laneous binaries image activators in the kernel.  It allows the adding,
     deleting, disabling, enabling, and looking up interpreters. Also, all the
     interpreters can be listed as well.

     The first argument on the command line indicates the operation to be per-
     formed.  Operation must be one of the following:

     add name --interpreter path --magic magic --size size [--mask mask]
	     [--offset offset] [--set-enabled]
	     Add a new activator entry in the kernel.  You must specify an
	     unique name, interpreter path and its arguments path, header
	     magic bytes that uniquely identifies a suitable binary for the
	     activator, and the size of the magic in bytes.

	     Optionally you may specify a mask to do a bitwise AND with the
	     header bytes.  This effectively allows you to ignore fields in
	     the binary header that do not uniquely indentfy binary file's
	     type.

	     An offset may be specified for the magic bytes using the --offset
	     argument.	By default the offset is zero.

	     To set the activator entry enabled the --set-enabled option is
	     used.  The activator default state is disabled.

	     The interpreter path may also arguments for the interpreter
	     including #a which gets replaced by the old argv0 value in the
	     interpreter string.

     remove name
	     Remove the activator entry identified with name.

     disable name
	     Disable the activator entry identified with name.

     enable name
	     Enable the activator entry identified with name.

     lookup name
	     Lookup and print out the activator entry identified with name.

     list    Take a snapshot and print all the activator entries currently
	     configured.

EXAMPLES
	   binmiscctl add llvmbc --interpreter ''/usr/bin/lli --fake-argv0=#a''
     --magic ''BC\xc0\xde'' --size 4 --set-enabled

     Add an image activator to run the the llvm interpreter (lli) on bitcode
     compiled files.  #a gets replaced with the old argv0 value so that 'lli'
     can fake its argv0.  Set its state to enabled.

	   binmiscctl disable llvmbc

     Set the state of the llvmbc image activator to disabled.

	   binmiscctl enable llvmbc

     Set the state of the llvmbc image activator to enabled.

	   binmiscctl remove llvmbc

     Delete the llvmbc image activator.

	   binmiscctl lookup llvmbc

     Lookup and list the record for the llvmbc image activator.

SEE ALSO
     execve(2) lli(1)

HISTORY
     The binmiscctl command was added in FreeBSD 10.0.	It was developed to
     support the imgact_binmisc kernel module.

AUTHORS
     Stacey D Son

FreeBSD 10.0			 May 14, 2013			  FreeBSD 10.0