Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
BINMISCCTL(8)		FreeBSD	System Manager's Manual		 BINMISCCTL(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 adding,
     deleting, disabling, enabling, and	looking	up interpreters.  Also,	all
     the interpreters can be listed.

     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	a
	     unique name, interpreter path and its arguments path, header
	     magic bytes that uniquely identify	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 indentify the binary
	     file's type.

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

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

	     The interpreter path may also contain arguments for the inter-
	     preter 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
	     Look up and print out the activator entry identified with name.

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

EXAMPLES
     Add an image activator to run the LLVM interpreter	(lli) on bitcode com-
     piled files:

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

     #a	is replaced with the old argv0 value so	that 'lli' can fake its	argv0.
     Set its state to enabled.

     Set the state of the llvmbc image activator to disabled:
	   # binmiscctl	disable	llvmbc

     Set the state of the llvmbc image activator to enabled:
	   # binmiscctl	enable llvmbc

     Delete the	llvmbc image activator:
	   # binmiscctl	remove llvmbc

     Look up and list the record for the llvmbc	image activator:
	   # binmiscctl	lookup llvmbc

     Add QEMU bsd-user program as an image activator for ARM little-endian
     binaries:

	   # binmiscctl	add armelf \
	     --interpreter "/usr/local/bin/qemu-arm-static" \
	     --magic "\x7f\x45\x4c\x46\x01\x01\x01\x00\x00\x00\
		      \x00\x00\x00\x00\x00\x00\x02\x00\x28\x00"	\
	     --mask  "\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\
		      \xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff"	\
	     --size 20 --set-enabled

     Add QEMU bsd-user program as an image activator for ARM big-endian	bina-
     ries:

	   # binmiscctl	add armebelf \
	     --interpreter "/usr/local/bin/qemu-arm-static" \
	     --magic "\x7f\x45\x4c\x46\x01\x02\x01\x00\x00\x00\
		      \x00\x00\x00\x00\x00\x00\x00\x02\x00\x28"	\
	     --mask  "\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\
		      \xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff"	\
	     --size 20 --set-enabled

     Add QEMU bsd-user program as an image activator for MIPS32	binaries:

	   # binmiscctl	add mips32 \
	     --interpreter "/usr/local/bin/qemu-mips-static" \
	     --magic "\x7f\x45\x4c\x46\x01\x02\x01\x00\x00\x00\
		      \x00\x00\x00\x00\x00\x00\x00\x02\x00\x08"	\
	     --mask  "\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\
		      \xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff"	\
	     --size 20 --set-enabled

     Add QEMU bsd-user program as an image activator for MIPS64	binaries:

	   # binmiscctl	add mips64 \
	     --interpreter "/usr/local/bin/qemu-mips64-static" \
	     --magic "\x7f\x45\x4c\x46\x02\x02\x01\x00\x00\x00\
		      \x00\x00\x00\x00\x00\x00\x00\x02\x00\x08"	\
	     --mask "\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\
		     \xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff" \
	     --size 20 --set-enabled

     Add QEMU bsd-user program as an image activator for PowerPC binaries:

	   # binmiscctl	add powerpc \
	     --interpreter "/usr/local/bin/qemu-ppc-static" \
	     --magic "\x7f\x45\x4c\x46\x01\x02\x01\x00\x00\x00\
		      \x00\x00\x00\x00\x00\x00\x00\x02\x00\x14"	\
	     --mask  "\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\
		      \xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff"	\
	     --size 20 --set-enabled

     Add QEMU bsd-user program as an image activator for PowerPC64 binaries:

	   # binmiscctl	add powerpc64 \
	     --interpreter "/usr/local/bin/qemu-ppc64-static" \
	     --magic "\x7f\x45\x4c\x46\x01\x02\x01\x00\x00\x00\
		      \x00\x00\x00\x00\x00\x00\x00\x02\x00\x15"	\
	     --mask  "\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\
		      \xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff"	\
	     --size 20 --set-enabled

     Add QEMU bsd-user program as an image activator for SPARC64 binaries:

	   # binmiscctl	add sparc64 \
	     --interpreter "/usr/local/bin/qemu-sparc64-static"	\
	     --magic "\x7f\x45\x4c\x46\x02\x02\x01\x00\x00\x00\
		      \x00\x00\x00\x00\x00\x00\x00\x02\x00\x2b"	\
	     --mask  "\xff\xff\xff\xff\xff\xff\xff\x00\xff\xff\
		      \xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff"	\
	     --size 20 --set-enabled

   Create and use an ARMv6 chroot on an	AMD64 host
     Use an existing source tree to build a chroot host	with architecture
     overrides:

     D=/path/to/chroot
     cd	/usr/src
     mkdir -p $D
     make world	TARGET=arm TARGET_ARCH=armv6 DESTDIR=$D
     make distribution TARGET=arm TARGET_ARCH=armv6 DESTDIR=$D

     With emulators/qemu-user-static from the FreeBSD Ports Collection,	the
     emulator must be copied into the jail path	specified in the binmiscctl
     command.  Using the example above:

     mkdir $D/usr/local/bin
     cp	/usr/local/bin/qemu-arm-static $D/usr/local/bin

     Now the user can chroot into the environment normally, as root:

     chroot $D

SEE ALSO
     lli(1), execve(2),	jail(8)

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

AUTHORS
     Stacey D Son

FreeBSD	10.3		       December	30, 2014		  FreeBSD 10.3

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=binmiscctl&sektion=8&manpath=FreeBSD+10.3-RELEASE+and+Ports>

home | help