Linkfarming
Linkfarming is a technique employed by XPI and AndrewPantyukhin/NPAPI ports ("miniports") for greater flexibility in installation.
Each miniport is installed in LOCALBASE/lib/infra/ID/ (where infra is either "xpi" or "npapi", and ID is unique for each miniport). Symlinks are then farmed in apps, usually lib/appname/{extensions,plugins}/. Once there was an idea to make a separate port, to support advanced linkfarming - allowing user to tune which miniports go to which apps, and to allow packages to invoke linkfarming. We've come to an arguably simpler solution.
There is a folder named LOCALBASE/lib/infra/symlinks/. In it, folders for each app (symlinks/firefox/, symlinks/linux-flock/, ...) In each of those, symlinks which can be copied verbatim into apps. Miniports only have to make one more linkfarming, while apps can just exec the following line on install/upgrade to instantly get all the miniports they are supposed to get:
cp -R LOCALBASE/lib/infra/symlinks/appname/ PREFIX/lib/appname/{extensions,plugins}/
Linkfarming is important as we might employ it in development of a new-generation packaging architecture. Systems like SEPP offer great flexibility in shlib management, requiring copies of libs kept along within each package. Symlinking can solve the disk space issue and provide for some design improvements. Consider this XPI/NPAPI linkfarming effort as a useful playground serving for development of simple, but powerful techniques.
Smart linkfarming in detail
- Every miniport knows a list of all apps supported by the infrastructure.
- The list can be stored in a common makefile.
- The lists for different infrastructures (plugins and extensions) can differ. E.g. opera supports NPAPI, but not XPI.
- Each miniport creates the symlinks dir and subdirs for each app in the list (even if the miniport itself does not support some of the apps). Miniports preen empty dirs on deinstall.
- Miniports can specify apps they support by full name (linux-firefox-devel) or shell wildcards (*mozilla*).
- Of course, it is possible for a miniport to support only a subset of infrastructure-supported apps. E.g. XPI supports many apps, but many extensions only work in *firefox* or *firefox.
- The list of miniport-supported apps is user-tunable. E.g. a user might want to have only mplayer-plugin in firefox and only mozplugger in seamonkey. By default both plugins would be installed in both browsers.
When miniport is installed it creates links for supported apps both in apps dirs and in symlink subdirs.
When app is installed it copies links from the symlink subdir with matching title over to its subdirs. Apps preen their subdirs for links on deinstall. Thus the infrastructure is fully portupgrade-safe and quite user-friendly.
Linkfarming by example
We're installing www/xpi-adblock:
- Extension is installed in PREFIX/lib/xpi/{34274bf4-1d97-a289-e984-17e546307e4f}/
PREFIX/lib/xpi/symlinks/app is created for each of the infrastructure-supported apps. Some of them are firefox, linux-firefox, firefox-devel, linux-firefox-devel, flock, linux-seamonkey, etc.
Links are created in PREFIX/lib/xpi/symlinks/app for each adblock-supported app - *firefox* and *flock*. In fact, mozilla and netscape are also supported by adblock, but XPI infrastructure does not support them yet, so they are not touched.
- Links are created in each supported app's extension subdir. In our case this will be X11BASE/lib/{*firefox*,*flock*}/extensions/. If firefox and/or flock are not installed, creation of some links is skipped silently.
We're installing www/linux-firefox:
- Browser is installed in PREFIX/lib/linux-firefox.
- Links are copied from LOCALBASE/lib/xpi/symlinks/linux-firefox/ over to PREFIX/lib/linux-firefox/extensions/.
We're deinstalling www/xpi-adblock:
Extension is deleted from PREFIX/lib/xpi/xpi-id.
Adblock-specific links are deleted from PREFIX/lib/xpi/symlinks/app for each adblock-supported app.
- Adblock-specific links are deleted from each supported app's extension subdir.
Any empty dirs among PREFIX/lib/xpi/symlinks/app (for each of the infrastructure-supported apps), PREFIX/lib/xpi/symlinks, and PREFIX/lib/xpi are deleted.
We're deinstalling www/linux-firefox:
- Links are preened in PREFIX/lib/linux-firefox/extensions/.
- Browser is deleted from PREFIX/lib/linux-firefox.