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] [-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
  16 Verbose mode; show all commands that modify the package build directory.
  17 .TP
  18 .B \-a
  19 Generate shlibs files for all architecture dependent packages.
  20 .TP
  21 .B \-i
  22 Generate shlibs files for all architecture independent packages.
  23 .TP
  24 .B \-ppackage
  25 Generate shlibs file for the package named "package".
  26 .TP
  27 .B \-Ptmpdir
  28 Use "tmpdir" for package build directory.
  29 .TP
  30 .B \-mmajor
  31 Instead of trying to guess the major number of the library from the filename
  32 of the library, use the major number specified after the -m parameter.
  33 .TP
  34 .B \-V [dependancies]
  35 By default, the shlibs file generated by this program does not make packages
  36 depend on any particular version of the package containing the shared
  37 library. It may be necessary for you to add some version dependancy
  38 information to the shlibs file. If -V is specified with no dependancy
  39 information, the current version of the package is plugged into a dependancy
  40 that looks like "packagename (>= packageversion)". If -V is specified with
  41 parameters, the parameters can be used to specify the exact dependancy
  42 information needed (be sure to include the package name).
  43 .SH EXAMPLES
  44 .TP
  45 .B dh_makeshlibs
  46 Assuming this is a package named libfoobar1, generates a shlibs file that
  47 looks something like:
  48   libfoobar 1 libfoobar1
  49 .TP
  50 .B dh_makeshlibs \-V
  51 Assuming the current version of the package is 1.0-3, generates a shlibs
  52 file that looks something like:
  53   libfoobar 1 libfoobar1 (>= 1.0-3)
  54 .TP
  55 .B dh_makeshlibs \-V "libfoobar1 (>= 1.0)"
  56 Generates a shlibs file that looks something like:
  57   libfoobar 1 libfoobar1 (>= 1.0)
  58 .SH NOTES
  59 The
  60 .B \-a
  61 .B \-i
  62 and
  63 .B \-p
  64 arguments are cumulative. If none are specified, then all packages listed in
  65 the control file will be effected.
  66 .SH ENVIRONMENT
  67 .TP
  68 .I DH_VERBOSE
  69 Enables verbose mode
  70 .SH "SEE ALSO"
  71 .BR /usr/doc/debhelper/README
  72 .SH BUGS
  73 Due to limitations in
  74 .BR getopt (1)
  75 , I had to fudge a bit on how the -V parameter really works. When -V is
  76 specified, it's really examining the rest of the command line for any text
  77 that isn't a switch, and using that for the dependancy information. This
  78 means that the -V switch and any dependancy parameters should come last on
  79 the command line.
  80 .P
  81 There is no guarantee that the program will get the shlibs file right. For
  82 example, it may not correctly guess the major number of your package. In
  83 cases like these (and perhaps in general, just to be safe), it is better to
  84 create a debian/shlibs file by hand, or force it to use the correct major
  85 number by specifying the -m parameter.
  86 .P
  87 This is a "do what I Mean" type program - you have been warned!
  88 .SH AUTHOR
  89 Joey Hess <joeyh@master.debian.org>