docs/linux_plugins.md

   1 # Linux Plugins
   2
   3 ## Background reading materials
   4
   5 ### Plugins in general
   6
   7 *   [Gecko Plugin API reference](https://developer.mozilla.org/en/Gecko_Plugin_API_Reference)
   8     -- most important to read
   9 *   [Mozilla plugins site](http://www.mozilla.org/projects/plugins/)
  10 *   [XEmbed extension](https://developer.mozilla.org/en/XEmbed_Extension_for_Mozilla_Plugins)
  11     -- newer X11-specific plugin API
  12 *   [NPAPI plugin guide](http://gplflash.sourceforge.net/gplflash2_blog/npapi.html)
  13     from GPLFlash project
  14
  15 ### Chromium-specific
  16
  17 *   [Chromium's plugin architecture](http://dev.chromium.org/developers/design-documents/plugin-architecture)
  18     -- may be out of date but will be worth reading
  19
  20 ## Code to reference
  21
  22 *   [Mozilla plugin code](http://mxr.mozilla.org/firefox/source/modules/plugin/base/src/)
  23     -- useful reference
  24 *   [nspluginwrapper](http://gwenole.beauchesne.info//en/projects/nspluginwrapper)
  25     -- does out-of-process plugins itself
  26
  27 ## Terminology
  28
  29 *   _Internal plugin_: "a plugin that's implemented in the chrome dll, i.e.
  30     there's no external dll that services that mime type. For Linux you'll just
  31     have to worry about the default plugin, which is what shows a puzzle icon
  32     for content that you don't have a plugin for.  We use that to allow the user
  33     to download and install the missing plugin."
  34
  35 ## Flash
  36
  37 *   [Adobe Flash player dev center](http://www.adobe.com/devnet/flashplayer/)
  38 *   [penguin.swf](http://blogs.adobe.com/penguin.swf/) -- blog about Flash on
  39     Linux
  40 *   [tips and tricks](http://macromedia.mplug.org/) -- user-created page, with
  41     some documentation of special flags in `/etc/adobe/mms.cfg`
  42 *   [official Adobe bug tracker](https://bugs.adobe.com/flashplayer/)
  43
  44 ## Useful Tools
  45
  46 *   `xwininfo -tree` -- lets you inspect the window hierarchy of a window and
  47     get the layout of child windows.
  48 *   "[DiamondX](http://multimedia.cx/diamondx/) is a simple NPAPI plugin built
  49     to run on Unix platforms and exercise the XEmbed browser extension."
  50     *   To build a 32-bit binary:
  51         `./configure CFLAGS='-m32' LDFLAGS='-L/usr/lib32 -m32'`