diff options
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 76 |
1 files changed, 38 insertions, 38 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 0fcb7b7064..0056ae7ac7 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -7387,17 +7387,17 @@ | |||
7387 | it is based on is by definition incomplete. | 7387 | it is based on is by definition incomplete. |
7388 | The purpose of the command is to allow the generation of | 7388 | The purpose of the command is to allow the generation of |
7389 | customized images, and as such, was designed to be | 7389 | customized images, and as such, was designed to be |
7390 | completely extensible through a plug-in interface. | 7390 | completely extensible through a plugin interface. |
7391 | See the | 7391 | See the |
7392 | "<link linkend='wic-using-the-wic-plug-ins-interface'>Using the Wic Plug-Ins Interface</link>" | 7392 | "<link linkend='wic-using-the-wic-plugin-interface'>Using the Wic PlugIn Interface</link>" |
7393 | section for information on these plug-ins. | 7393 | section for information on these plugins. |
7394 | </para> | 7394 | </para> |
7395 | 7395 | ||
7396 | <para> | 7396 | <para> |
7397 | This section provides some background information on Wic, | 7397 | This section provides some background information on Wic, |
7398 | describes what you need to have in | 7398 | describes what you need to have in |
7399 | place to run the tool, provides instruction on how to use | 7399 | place to run the tool, provides instruction on how to use |
7400 | the Wic utility, provides information on using the Wic plug-ins | 7400 | the Wic utility, provides information on using the Wic plugins |
7401 | interface, and provides several examples that show how to use | 7401 | interface, and provides several examples that show how to use |
7402 | Wic. | 7402 | Wic. |
7403 | </para> | 7403 | </para> |
@@ -7792,28 +7792,28 @@ | |||
7792 | </para> | 7792 | </para> |
7793 | </section> | 7793 | </section> |
7794 | 7794 | ||
7795 | <section id='wic-using-the-wic-plug-ins-interface'> | 7795 | <section id='wic-using-the-wic-plugin-interface'> |
7796 | <title>Using the Wic Plug-Ins Interface</title> | 7796 | <title>Using the Wic Plugin Interface</title> |
7797 | 7797 | ||
7798 | <para> | 7798 | <para> |
7799 | You can extend and specialize Wic functionality by using | 7799 | You can extend and specialize Wic functionality by using |
7800 | Wic plug-ins. | 7800 | Wic plugins. |
7801 | This section explains the Wic plug-in interface. | 7801 | This section explains the Wic plugin interface. |
7802 | <note> | 7802 | <note> |
7803 | Wic plug-ins consist of "source" and "imager" plug-ins. | 7803 | Wic plugins consist of "source" and "imager" plugins. |
7804 | Imager plug-ins are beyond the scope of this section. | 7804 | Imager plugins are beyond the scope of this section. |
7805 | </note> | 7805 | </note> |
7806 | </para> | 7806 | </para> |
7807 | 7807 | ||
7808 | <para> | 7808 | <para> |
7809 | Source plug-ins provide a mechanism to customize partition | 7809 | Source plugins provide a mechanism to customize partition |
7810 | content during the Wic image generation process. | 7810 | content during the Wic image generation process. |
7811 | You can use source plug-ins to map values that you specify | 7811 | You can use source plugins to map values that you specify |
7812 | using <filename>--source</filename> commands in kickstart | 7812 | using <filename>--source</filename> commands in kickstart |
7813 | files (i.e. <filename>*.wks</filename>) to a plug-in | 7813 | files (i.e. <filename>*.wks</filename>) to a plugin |
7814 | implementation used to populate a given partition. | 7814 | implementation used to populate a given partition. |
7815 | <note> | 7815 | <note> |
7816 | If you use plug-ins that have build-time dependencies | 7816 | If you use plugins that have build-time dependencies |
7817 | (e.g. native tools, bootloaders, and so forth) | 7817 | (e.g. native tools, bootloaders, and so forth) |
7818 | when building a Wic image, you need to specify those | 7818 | when building a Wic image, you need to specify those |
7819 | dependencies using the | 7819 | dependencies using the |
@@ -7823,43 +7823,43 @@ | |||
7823 | </para> | 7823 | </para> |
7824 | 7824 | ||
7825 | <para> | 7825 | <para> |
7826 | Source plug-ins are subclasses defined in plug-in files. | 7826 | Source plugins are subclasses defined in plugin files. |
7827 | As shipped, the Yocto Project provides several plug-in | 7827 | As shipped, the Yocto Project provides several plugin |
7828 | files. | 7828 | files. |
7829 | You can see the source plug-in files that ship with the | 7829 | You can see the source plugin files that ship with the |
7830 | Yocto Project | 7830 | Yocto Project |
7831 | <ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/poky/tree/scripts/lib/wic/plugins/source'>here</ulink>. | 7831 | <ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/poky/tree/scripts/lib/wic/plugins/source'>here</ulink>. |
7832 | Each of these plug-in files contains source plug-ins that | 7832 | Each of these plugin files contains source plugins that |
7833 | are designed to populate a specific Wic image partition. | 7833 | are designed to populate a specific Wic image partition. |
7834 | </para> | 7834 | </para> |
7835 | 7835 | ||
7836 | <para> | 7836 | <para> |
7837 | Source plug-ins are subclasses of the | 7837 | Source plugins are subclasses of the |
7838 | <filename>SourcePlugin</filename> class, which is | 7838 | <filename>SourcePlugin</filename> class, which is |
7839 | defined in the | 7839 | defined in the |
7840 | <filename>poky/scripts/lib/wic/pluginbase.py</filename> | 7840 | <filename>poky/scripts/lib/wic/pluginbase.py</filename> |
7841 | file. | 7841 | file. |
7842 | For example, the <filename>BootimgEFIPlugin</filename> | 7842 | For example, the <filename>BootimgEFIPlugin</filename> |
7843 | source plug-in found in the | 7843 | source plugin found in the |
7844 | <filename>bootimg-efi.py</filename> file is a subclass of | 7844 | <filename>bootimg-efi.py</filename> file is a subclass of |
7845 | the <filename>SourcePlugin</filename> class, which is found | 7845 | the <filename>SourcePlugin</filename> class, which is found |
7846 | in the <filename>pluginbase.py</filename> file. | 7846 | in the <filename>pluginbase.py</filename> file. |
7847 | </para> | 7847 | </para> |
7848 | 7848 | ||
7849 | <para> | 7849 | <para> |
7850 | You can also implement source plug-ins in a layer outside | 7850 | You can also implement source plugins in a layer outside |
7851 | of the Source Repositories (external layer). | 7851 | of the Source Repositories (external layer). |
7852 | To do so, be sure that your plug-in files are located in | 7852 | To do so, be sure that your plugin files are located in |
7853 | a directory whose path is | 7853 | a directory whose path is |
7854 | <filename>scripts/lib/wic/plugins/source/</filename> | 7854 | <filename>scripts/lib/wic/plugins/source/</filename> |
7855 | within your external layer. | 7855 | within your external layer. |
7856 | When the plug-in files are located there, the source | 7856 | When the plugin files are located there, the source |
7857 | plug-ins they contain are made available to Wic. | 7857 | plugins they contain are made available to Wic. |
7858 | </para> | 7858 | </para> |
7859 | 7859 | ||
7860 | <para> | 7860 | <para> |
7861 | When the Wic implementation needs to invoke a | 7861 | When the Wic implementation needs to invoke a |
7862 | partition-specific implementation, it looks for the plug-in | 7862 | partition-specific implementation, it looks for the plugin |
7863 | with the same name as the <filename>--source</filename> | 7863 | with the same name as the <filename>--source</filename> |
7864 | parameter used in the kickstart file given to that | 7864 | parameter used in the kickstart file given to that |
7865 | partition. | 7865 | partition. |
@@ -7869,13 +7869,13 @@ | |||
7869 | part /boot --source bootimg-pcbios --ondisk sda --label boot --active --align 1024 | 7869 | part /boot --source bootimg-pcbios --ondisk sda --label boot --active --align 1024 |
7870 | </literallayout> | 7870 | </literallayout> |
7871 | The methods defined as class members of the matching | 7871 | The methods defined as class members of the matching |
7872 | source plug-in (i.e. <filename>bootimg-pcbios</filename>) | 7872 | source plugin (i.e. <filename>bootimg-pcbios</filename>) |
7873 | in the <filename>bootimg-pcbios.py</filename> plug-in file | 7873 | in the <filename>bootimg-pcbios.py</filename> plugin file |
7874 | are used. | 7874 | are used. |
7875 | </para> | 7875 | </para> |
7876 | 7876 | ||
7877 | <para> | 7877 | <para> |
7878 | To be more concrete, here is the corresponding plug-in | 7878 | To be more concrete, here is the corresponding plugin |
7879 | definition from the <filename>bootimg-pcbios.py</filename> | 7879 | definition from the <filename>bootimg-pcbios.py</filename> |
7880 | file for the previous command along with an example | 7880 | file for the previous command along with an example |
7881 | method called by the Wic implementation when it needs to | 7881 | method called by the Wic implementation when it needs to |
@@ -7907,19 +7907,19 @@ | |||
7907 | . | 7907 | . |
7908 | . | 7908 | . |
7909 | </literallayout> | 7909 | </literallayout> |
7910 | If a subclass (plug-in) itself does not implement a | 7910 | If a subclass (plugin) itself does not implement a |
7911 | particular function, Wic locates and uses the default | 7911 | particular function, Wic locates and uses the default |
7912 | version in the superclass. | 7912 | version in the superclass. |
7913 | It is for this reason that all source plug-ins are derived | 7913 | It is for this reason that all source plugins are derived |
7914 | from the <filename>SourcePlugin</filename> class. | 7914 | from the <filename>SourcePlugin</filename> class. |
7915 | </para> | 7915 | </para> |
7916 | 7916 | ||
7917 | <para> | 7917 | <para> |
7918 | The <filename>SourcePlugin</filename> class defined in | 7918 | The <filename>SourcePlugin</filename> class defined in |
7919 | the <filename>pluginbase.py</filename> file defines | 7919 | the <filename>pluginbase.py</filename> file defines |
7920 | a set of methods that source plug-ins can implement or | 7920 | a set of methods that source plugins can implement or |
7921 | override. | 7921 | override. |
7922 | Any plug-ins (subclass of | 7922 | Any plugins (subclass of |
7923 | <filename>SourcePlugin</filename>) that do not implement | 7923 | <filename>SourcePlugin</filename>) that do not implement |
7924 | a particular method inherit the implementation of the | 7924 | a particular method inherit the implementation of the |
7925 | method from the <filename>SourcePlugin</filename> class. | 7925 | method from the <filename>SourcePlugin</filename> class. |
@@ -7980,11 +7980,11 @@ | |||
7980 | </para> | 7980 | </para> |
7981 | 7981 | ||
7982 | <para> | 7982 | <para> |
7983 | You can extend the source plug-in mechanism. | 7983 | You can extend the source plugin mechanism. |
7984 | To add more hooks, create more source plug-in methods | 7984 | To add more hooks, create more source plugin methods |
7985 | within <filename>SourcePlugin</filename> and the | 7985 | within <filename>SourcePlugin</filename> and the |
7986 | corresponding derived subclasses. | 7986 | corresponding derived subclasses. |
7987 | The code that calls the plug-in methods uses the | 7987 | The code that calls the plugin methods uses the |
7988 | <filename>plugin.get_source_plugin_methods()</filename> | 7988 | <filename>plugin.get_source_plugin_methods()</filename> |
7989 | function to find the method or methods needed by the call. | 7989 | function to find the method or methods needed by the call. |
7990 | Retrieval of those methods is accomplished by filling up | 7990 | Retrieval of those methods is accomplished by filling up |
@@ -9404,7 +9404,7 @@ | |||
9404 | 9404 | ||
9405 | <para> | 9405 | <para> |
9406 | Many pieces of software split functionality into optional | 9406 | Many pieces of software split functionality into optional |
9407 | modules (or plug-ins) and the plug-ins that are built | 9407 | modules (or plugins) and the plugins that are built |
9408 | might depend on configuration options. | 9408 | might depend on configuration options. |
9409 | To avoid having to duplicate the logic that determines what | 9409 | To avoid having to duplicate the logic that determines what |
9410 | modules are available in your recipe or to avoid having | 9410 | modules are available in your recipe or to avoid having |
@@ -15061,12 +15061,12 @@ | |||
15061 | </para> | 15061 | </para> |
15062 | 15062 | ||
15063 | <para> | 15063 | <para> |
15064 | Specifying audio and video plug-ins as part of the | 15064 | Specifying audio and video plugins as part of the |
15065 | <filename>COMMERCIAL_AUDIO_PLUGINS</filename> and | 15065 | <filename>COMMERCIAL_AUDIO_PLUGINS</filename> and |
15066 | <filename>COMMERCIAL_VIDEO_PLUGINS</filename> statements | 15066 | <filename>COMMERCIAL_VIDEO_PLUGINS</filename> statements |
15067 | (along with the enabling | 15067 | (along with the enabling |
15068 | <filename>LICENSE_FLAGS_WHITELIST</filename>) includes the | 15068 | <filename>LICENSE_FLAGS_WHITELIST</filename>) includes the |
15069 | plug-ins or components into built images, thus adding | 15069 | plugins or components into built images, thus adding |
15070 | support for media formats or components. | 15070 | support for media formats or components. |
15071 | </para> | 15071 | </para> |
15072 | </section> | 15072 | </section> |