Flash-related docs on the site

[Chris Turner]

Chris Turner wrote:
cheers will do
if anyone has any comments / wants to try before I change up the site -
going to do something like this -
getting a few items done first & will be applying
this + top business tomorrow.
--

Using nspluginwrapper with flash 9

Tested against DragonFlyBSD 2.6/i386, Firefox 3.6 on the pkgsrc-2010Q1 
branch

I lost track of the exact steps to do this - indeed if something is out
of place it won't work right - I think the trick is that nspluginwrapper
needs to be run inside a 'working' emulation environment in order to work.
Removing and then reinstalling the resulting binary packages 'just worked' -
so I think that is the 'gotcha'. This will need to be reworked for
binary packages, but the idea should be the same - setup the linux
environment, then install the packages.
*Note* : Linux emulation support on 64Bit DragonFly is not functional
  at the time of writing - so you'll need to run 32Bit DragonFly
  if you want this to work for now. (FIXME VERIFY)
So - step one: setup your linux emulation environment:

  - install multimedia/libflashsupport which should pull in the full
    linux setup::
      # cd /usr/pkgsrc/multimedia/libflashsupport
      # bmake package clean
  - configure DF for running linux binaries::

    - load the linux emulator::
      # kldload linux
      # kldload aac_linux # note - not sure if needed.. why not?
    - mount linprocfs::
      # mount -t linprocfs none /usr/pkg/emul/linux/proc
    - run linux ldconfig to setup the linux-side linker paths::
      # /compat/linux/sbin/ldconfig -a
Now, time for the nspluginwrapper and ns-flash install.

  - nspluginwrapper::

      # cd /usr/pkgsrc/www/ns-nspluginwrapper
      # bmake package clean
This should be it. Not sure if all of these were required.
probably were - I believe the symptom is errors like "Elf type '0' binary
unknown' - which means something like nspluginwrapper is having trouble 
doing
it's dlopen(3) magic or similar. You can check the installation with::

  # nspluginwrapper --list
  /usr/pkg/lib/netscape/plugins/npwrapper.libflashplayer.so
    Original plugin: /usr/pkg/lib/netscape/plugins/libflashplayer.so
    Wrapper version string: 1.2.2
  /usr/pkg/lib/netscape/plugins/npwrapper.libflashplayer.so
    Original plugin: /usr/pkg/lib/netscape/plugins/libflashplayer.so
    Wrapper version string: 1.2.2
No idea why it lists twice.

Also Note - even when it works, the following message will appear
when starting Firefox::
    LoadPlugin: failed to initialize shared library 
/usr/pkg/lib/netscape/plugin
s/libflashplayer.so [Shared object "libdl.so.2" not found, required by 
"libflash
player.so"]

This can be ignored - the real test of installation is to::

  1) Check about:plugins in the URL bar - you should have a plugin for::

    File: npwrapper.libflashplayer.so
    Version:
    Shockwave Flash 9.0 r283
  2) Try it out!

Enjoy - and please do report any problems to the users list.