manpagez: man pages & more
man redo_prebinding(1)
Home | html | info | man
redo_prebinding(1)                                          redo_prebinding(1)




NAME

       redo_prebinding  -  redo  the  prebinding  of  an executable or dynamic
       library


SYNOPSIS

       redo_prebinding [-c | -p | -d] [-i] [-z] [-u]  [-r  rootdir]  [-e  exe-
       cutable_path]  [-seg_addr_table table_file_name] [-seg_addr_table_file-
       name pathname] [-seg1addr address] [-o output_file] [-s] input_file


DESCRIPTION

       Redo_prebinding is used to redo the  prebinding  of  an  executable  or
       dynamic  library  when  one of the dependent dynamic libraries changes.
       The input file, executable or dynamic library, must have initially been
       prebound  for  this  program to redo the prebinding.  Also all depended
       libraries must have their prebinding up to date.  So when  redoing  the
       prebinding  for  libraries they must be done in dependency order.  Also
       when building executables or dynamic libraries that are to be  prebound
       (with  the  -prebind  options  to  ld(1)  or  libtool(1)) the dependent
       libraries must have their prebinding up to date or the result will  not
       be prebound.

       The  options  allow  for  different  types of checking for use in shell
       scripts.  Only one of -c, -p or -d can be used at a time.  If redo_pre-
       binding   redoes   the   prebinding  on  an  input  file  it  will  run
       /usr/bin/objcunique if it exists on the result.


OPTIONS

       -c     only check if the file needs to have it's prebinding redone  and
              return  status.   A  0 exit means the file's prebinding is up to
              date, 1 means it needs to be redone and 2 means it could not  be
              checked  for  reasons  like  a  dependent library is missing (an
              error message is printed in these cases).

       -p     check only for prebound files and return status.  An exit status
              of  1  means  the file is a Mach-O that could have been prebound
              and is not otherwise the exit status is 0.

       -d     check only for dynamic shared library files and  return  status.
              An  exit status of 0 means the file is a dynamic shared library,
              1 means the file is not, 2 means there is some mix in the archi-
              tectures.

       -i     ignore  non-prebound  files (useful when running on all types of
              files).

       -z     zero out the prebind check sum in the output if it has one.

       -u     unprebind, rather than  reprebind  (-c,  -p,  -d,  -e  ignored).
              Resets or removes prebinding-specific information from the input
              file.  As unprebinding is intended to produce a canonical Mach-O
              binary,  bundles  and  non-prebound  executables  and dylibs are
              acceptable as input.  For these files, the  unprebind  operation
              will  zero  library  time  stamps  and  version numbers and zero
              entries in the two-level hints table.

       -e executable_path
              replace any dependent library's "@executable_path"  prefix  with
              the executable_path argument.

       -seg_addr_table table_file_name
              The  -seg_addr_table  option  is  used  when the input a dynamic
              library and if specified the table entry for the install_name of
              the  dynamic  library  is  used  for checking and the address to
              relocate the library to as it prefered address.

       -seg_addr_table_filename pathname
              Use pathname instead of the install  name  of  the  library  for
              matching an entry in the segment address table.

       -seg1addr address
              Move  the  input  library  to base address address.  This option
              does not apply when -u, -seg_addr_table or -seg_addr_table_file-
              name are specified.

       -r rootdir
              prepend the rootdir argument to all dependent libraries.

       -o output_file
              write  the  updated  file into output_file rather than back into
              the input file.

       -s     write the updated file to standard output


DIAGNOSTICS

       With no -c, -p or -d an exit status of 0 means success and 2  means  it
       could  not  be done for reasons like a dependent library is missing (an
       error message is printed in these cases).  And exit of  3  is  for  the
       specific case when the dependent libraries are out of date with respect
       to each other.



Apple Computer, Inc.            March 29, 2004              redo_prebinding(1)

Mac OS X 10.6 - Generated Thu Sep 17 20:09:01 CDT 2009
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.