dh_makeshlibs.1

   1 .TH DH_MAKESHLIBS 1
   2 .SH NAME
   3 dh_makeshlibs \- automatically create shlibs file
   4 .SH SYNOPSIS
   5 .B dh_makeshlibs
   6 .I "[-v] [-a] [-i] [--no-act] [-mmajor] [-Ptmpdir] [-ppackage] [-mmajor] [-V[dependancies]]"
   7 .SH "DESCRIPTION"
   8 dh_makeshlibs is a debhelper program that automatically scans for shared
   9 libraries, and generates a shlibs file for the libraries it finds.
  10 .P
  11 For this program to work, you cannot have already installed a DEBIAN/shlibs
  12 file. If such a file exits, the program will exit with an error.
  13 .SH OPTIONS
  14 .TP
  15 .B \-v, \--verbose
  16 Verbose mode; show all commands that modify the package build directory.
  17 .TP
  18 .B \-a, \--arch
  19 Generate shlibs files for all architecture dependent packages.
  20 .TP
  21 .B \-i, \--indep
  22 Generate shlibs files for all architecture independent packages.
  23 .TP
  24 .B \--no-act
  25 Do not really do anything. If used with -v, the result is that this command
  26 will output a list of what it would have done.
  27 .TP
  28 .B \-ppackage, \--package=package
  29 Generate shlibs file for the package named "package".
  30 .TP
  31 .B \-Ptmpdir, \--tmpdir=tmpdir
  32 Use "tmpdir" for package build directory.
  33 .TP
  34 .B \-mmajor, \--major=major
  35 Instead of trying to guess the major number of the library from the filename
  36 of the library, use the major number specified after the -m parameter.
  37 .TP
  38 .B \-V[dependancies], \--version-info, \--version-info=dependancies
  39 By default, the shlibs file generated by this program does not make packages
  40 depend on any particular version of the package containing the shared
  41 library. It may be necessary for you to add some version dependancy
  42 information to the shlibs file. If -V is specified with no dependancy
  43 information, the current version of the package is plugged into a dependancy
  44 that looks like "packagename (>= packageversion)". If -V is specified with
  45 parameters, the parameters can be used to specify the exact dependancy
  46 information needed (be sure to include the package name).
  47 .SH EXAMPLES
  48 .TP
  49 .B dh_makeshlibs
  50 Assuming this is a package named libfoobar1, generates a shlibs file that
  51 looks something like:
  52   libfoobar 1 libfoobar1
  53 .TP
  54 .B dh_makeshlibs \-V
  55 Assuming the current version of the package is 1.0-3, generates a shlibs
  56 file that looks something like:
  57   libfoobar 1 libfoobar1 (>= 1.0-3)
  58 .TP
  59 .B dh_makeshlibs \-V "libfoobar1 (>= 1.0)"
  60 Generates a shlibs file that looks something like:
  61   libfoobar 1 libfoobar1 (>= 1.0)
  62 .SH NOTES
  63 The
  64 .B \-a
  65 .B \-i
  66 and
  67 .B \-p
  68 arguments are cumulative. If none are specified, then all packages listed in
  69 the control file will be effected.
  70 .SH ENVIRONMENT
  71 .TP
  72 .I DH_VERBOSE
  73 Enables verbose mode
  74 .TP
  75 .I DH_NO_ACT
  76 Enables no-act mode (see above).
  77 .SH "SEE ALSO"
  78 .BR /usr/doc/debhelper/README
  79 .SH BUGS
  80 There is no guarantee that the program will get the shlibs file right. For
  81 example, it may not correctly guess the major number of your package. In
  82 cases like these (and perhaps in general, just to be safe), it is better to
  83 create a debian/shlibs file by hand, or force it to use the correct major
  84 number by specifying the -m parameter.
  85 .P
  86 This is a "do what I Mean" type program - you have been warned!
  87 .SH AUTHOR
  88 Joey Hess <joeyh@master.debian.org>