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

FreeBSD Manual Pages

  
 
  

home | help
MUSE(1)			    General Commands Manual		       MUSE(1)

NAME
       muse

SYNOPSIS
       muse -o out -p pkg [-h] [-d dbg]	[-l libs] [file...]

DESCRIPTION
       The muse	tool acts as a linker for .use files. It reads all of the use-
       files  provided to it on	the command line, filters them by package, and
       outputs a new usefile with the merged  set  of  symbols.	 Both  the  -o
       out.use and the -p pkg options are mandatory.

       The  output of muse is architecture-independent.	However, the format of
       the generated file is not stable, and is	not guaranteed to work	across
       different compiler versions.

       The muse	options	are:

       -d [flTri]
	      Print  debugging	dumps. Additional options may be given to give
	      more debugging information for specific intermediate  states  of
	      the compilation.

       -h     Print a summary of the available options.

       -p package
	      Take  the	symbols	that match package and their dependencies, and
	      merge them into a	single	package.  Only	symbols	 matching  the
	      package name will	be reexported.

       -o output-file
	      Specify  that the	generated usefile should be named output-file.
	      By convention, output-file should	match up with the package name
	      given to the -p option.

EXAMPLE
	   muse	-o library.use -p library foo.use bar.use

FILES
       The   source   for   muse   is	 available    from    git://git.eigen-
       state.org/git/ori/mc.git	 and  lives  in	the muse/ directory within the
       source tree.

SEE ALSO
       6m(1) ld(1) as(1)

BUGS
       There is	insufficient checking and validation done on usefiles.

       The file	format is in flux, and in current iterations, it is not	at all
       compact.

       There is	no versioning on the usefiles as it stands.  If	 you  use  the
       wrong  version with the wrong compiler, a mysterious error or even seg-
       fault is	likely.

       This utility should not exist. Instead, the compiler should put the ex-
       ported symbol information into the object file or library directly.

       The file	format is not closed under concatentation.

								       MUSE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=muse&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help