LIPO(1) LIPO(1)

NAME
       lipo - create or operate on universal files

SYNOPSIS
       lliippoo  [-info]  [-detailedinfo]  [-arch  archtype  inputfile]  ...  [
       inputfile] ...  [-archblank archtype]  [-create]  [-thin  archtype]
       [-replace  archtype  filename] ...  [-remove archtype] ...  [-extract
       archtype]  ...    [-extractfamily   archtype]   ...    [-verifyarch
       archtype ...]  [-output outputfile] [-segalign archtype value] ...

DESCRIPTION
       The  lipo command creates or operates on ``universal'' (multi-architec-
       ture) files.  It only ever produces one output file, and  never  alters
       the  input  file.   The  operations that lipo performs are: listing the
       architecture types in a universal file;  creating  a  single  universal
       file from one or more input files; thinning out a single universal file
       to one specified architecture type; and extracting,  replacing,  and/or
       removing architectures types from the input file to create a single new
       universal output file.

       Only one  option  can  be  specified,  with  the  exception  of  -aarrcchh,
       -aarrcchhbbllaannkk, -oouuttppuutt, and -sseeggaalliiggnn, which are used in combination with
       other options.  The inputfile argument is required, and only the -ccrree-
       aattee  option allows more than one inputfile to be specified.  The -oouutt-
       ppuutt flag must be used, except with the -iinnffoo and -ddeettaaiilleeddiinnffoo  flags.

       The  archtype arguments may be any of the supported architecture names
       listed in the man page arch(3).

OOPPTTIIOONNSS
       -iinnffoo  Briefly list the architecture types in the input universal  file
              (just the names of each architecture).

       -ddeettaaiilleeddiinnffoo
              Display  a  detailed list of the architecture types in the input
              universal file (all the the information in the universal header,
              for each architecture in the file).

       -aarrcchh archtype inputfile
              Tells  lipo  that inputfile contains the specified architecture
              type.  The  -aarrcchh  archtype  specification  is  unnecessary  if
              inputfile  is  an  object file, a universal file, or some other
              file whose architecture(s) lipo can figure out.

       -aarrcchhbbllaannkk archtype
              Specifies that the output for the specified archtype will be an
              MHDYLIBSTUB file. This flag may not be used with any operation
              other than -ccrreeaattee.

       -oouuttppuutt outputfile
              Specifies its argument to be the output file.

       -ccrreeaattee
              Take the input files (or file) and create one  universal  output
              file from them.

       -tthhiinn archtype
              Take one input file and create a thin output file with the spec-
              ified archtype.

       -rreeppllaaccee archtype filename
              Take one universal input file; in the output file,  replace  the
              archtype  contents  of  the input file with the contents of the
              specified filename.

       -rreemmoovvee archtype
              Take one universal input file and remove the archtype from that
              universal file, placing the result in the output file.

       -eexxttrraacctt archtype
              Take  one  universal input file and copy the archtype from that
              universal file into a universal output file containing only that
              architecture.

       -eexxttrraaccttffaammiillyy archtype
              Take one universal input file and copy all of the archtypes for
              the family that archtype is in from that universal file into an
              output  file containing only those architectures.  The file will
              be thin if only one architecture is found  or  universal  other-
              wise.

       -vveerriiffyyaarrcchh archtype ...
              Take  one  input  file  and  verify the specified archtypes are
              present in the file.  If so then exit with a status  of  0  else
              exit with a status of 1.

       -sseeggaalliiggnn archtype value
              Set the segment alignment of the specified archtype when creat-
              ing a universal file containing that architecture.  value  is  a
              hexadecimal number that must be an integral power of 2.  This is
              only needed when lipo can't figure out the alignment of an input
              file  (currently  not an object file), or when it guesses at the
              alignment too conservatively.  The default for files unknown  to
              lipo  is  0  (2^0, or an alignment of one byte), and the default
              alignment for archives is 4 (2^2, or 4-byte alignment).

SEE ALSO
       arch(3)



Apple Computer, Inc.          September 12, 2006                       LIPO(1)