LIPO(1)                                                   LIPO(1)



NAME
       lipo - create or operate on fat files

SYNOPSIS
       lipo [-info] [-detailed_info] [-arch arch_type input_file]
       ...   [  input_file]  ...   [-create]  [-thin   arch_type]
       [-replace arch_type filename] ...  [-remove arch_type] ...
       [-extract arch_type] ...  [-extract_family arch_type]  ...
       [-output output_file] [-segalign arch_type value] ...

DESCRIPTION
       The  lipo  command  creates or operates on ``fat'' (multi-
       architecture) 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  fat  file;  creating a single fat file from one or more
       input files; thinning out a single fat file to one  speci-
       fied  architecture type; and extracting, replacing, and/or
       removing architectures types from the input file to create
       a single new fat output file.

       Only  one  option  can be specified, with the exception of
       -arch, -output, and -segalign, which are used in  combina-
       tion  with  other  options.   The  input_file  argument is
       required, and only the -create option allows more than one
       input_file  to  be  specified.   The  -output flag must be
       used, except with the -info and -detailed_info flags.

       The arch_type arguments may be any of the supported archi-
       tecture  names  listed  in  the man page arch(3)exceptfor-
       VAXandMips.

OPTIONS
       -info  Briefly list the architecture types  in  the  input
              fat file (just the names of each architecture).

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

       -arch arch_type input_file
              Tells lipo that input_file contains  the  specified
              architecture  type.  The -arch arch_type specifica-
              tion is unnecessary  if  input_file  is  an  object
              file,  a  fat file, or some other file whose archi-
              tecture(s) lipo can figure out.

       -output output_file
              Specifies its argument to be the output file.

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

       -thin arch_type
              Take  one  input file and create a thin output file
              with the specified arch_type.

       -replace arch_type file_name
              Take one  fat  input  file;  in  the  output  file,
              replace  the  arch_type  contents of the input file
              with the contents of the specified file_name.

       -remove arch_type
              Take one fat input file and  remove  the  arch_type
              from  that fat file, placing the result in the out-
              put file.

       -extract arch_type
              Take one fat input file and copy the arch_type from
              that  fat  file  into  a fat output file containing
              only that architecture.

       -extract_family arch_type
              Take one  fat  input  file  and  copy  all  of  the
              arch_types for the family that arch_type is in from
              that fat file into an output file  containing  only
              those architectures.  The file will be thin if only
              one architecture is found or fat otherwise.

       -segalign arch_type value
              Set  the  segment  alignment   of   the   specified
              arch_type  when creating a fat 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  conserva-
              tively.  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 align-
              ment).

SEE ALSO
       arch(3)



Apple Computer, Inc.     October 23, 1997                 LIPO(1)