Differences

This shows you the differences between two versions of the page.

doc:devel:feeds [2013/05/09 01:41]
orca
doc:devel:feeds [2014/09/07 12:55] (current)
rpjday Add supported src-gitsvn update method to table.
Line 1: Line 1:
====== OpenWrt Feeds ====== ====== OpenWrt Feeds ======
-A feed in OpenWrt is a collection of [[doc:devel:packages]] which share a common location.  Feeds may reside on a remote server, in a version control system, on the local filesystem, or in any other location addressable by a single name (path/URL) over a protocol with a supported feed method.+In OpenWrt, a "feed" is a collection of [[doc:devel:packages]] which share a common location.  Feeds may reside on a remote server, in a version control system, on the local filesystem, or in any other location addressable by a single name (path/URL) over a protocol with a supported feed method.
Feeds are additional predefined package build recipes for OpenWrt Buildroot. Feeds are additional predefined package build recipes for OpenWrt Buildroot.
Line 12: Line 12:
''feeds.conf.default'' when ''feeds.conf'' does not exist).  This file contains a list of feeds, one per line, and any number of empty lines.  Comments begin with # and extend to the end of a line and are ignored during parsing.  Each feed line consists of 3 whitespace-separated components:  The feed method, the feed name, and the feed source. ''feeds.conf.default'' when ''feeds.conf'' does not exist).  This file contains a list of feeds, one per line, and any number of empty lines.  Comments begin with # and extend to the end of a line and are ignored during parsing.  Each feed line consists of 3 whitespace-separated components:  The feed method, the feed name, and the feed source.
-As of this writing the file ''<builroot dir>/feeds.conf.default'' contains:+As of r41875 the file ''<buildroot dir>/feeds.conf.default'' contains:
<file xml feeds.conf.default> <file xml feeds.conf.default>
-src-svn  packages svn://svn.openwrt.org/openwrt/packages +src-git packages https://github.com/openwrt/packages.git 
-src-svn  xwrt      http://x-wrt.googlecode.com/svn/trunk/package +src-git luci http://git.openwrt.org/project/luci.git 
-src-git   luci      git://nbd.name/luci.git +src-git routing https://github.com/openwrt-routing/packages.git 
-src-git   routing  git://github.com/openwrt-routing/packages.git +src-git telephony http://git.openwrt.org/feed/telephony.git 
-src-git   telephony http://feeds.openwrt.nanl.de/openwrt/telephony.git +src-git management https://github.com/openwrt-management/packages.git 
-#src-svn phone     svn://svn.openwrt.org/openwrt/feeds/phone +#src-git oldpackages http://git.openwrt.org/packages.git 
-#src-svn efl       svn://svn.openwrt.org/openwrt/feeds/efl +#src-svn xwrt http://x-wrt.googlecode.com/svn/trunk/package 
-#src-svn xorg     svn://svn.openwrt.org/openwrt/feeds/xorg +#src-svn phone svn://svn.openwrt.org/openwrt/feeds/phone 
-#src-svn desktop   svn://svn.openwrt.org/openwrt/feeds/desktop +#src-svn efl svn://svn.openwrt.org/openwrt/feeds/efl 
-#src-svn xfce     svn://svn.openwrt.org/openwrt/feeds/xfce +#src-svn xorg svn://svn.openwrt.org/openwrt/feeds/xorg 
-#src-svn lxde     svn://svn.openwrt.org/openwrt/feeds/lxde +#src-svn desktop svn://svn.openwrt.org/openwrt/feeds/desktop 
-#src-link custom   /usr/src/openwrt/custom-feed+#src-svn xfce svn://svn.openwrt.org/openwrt/feeds/xfce 
 +#src-svn lxde svn://svn.openwrt.org/openwrt/feeds/lxde 
 +#src-link custom /usr/src/openwrt/custom-feed
</file> </file>
Line 34: Line 36:
| src-cpy  | Data is copied from the source path | | src-cpy  | Data is copied from the source path |
| src-darcs | Data is downloaded from the source path/URL using ''darcs'' | | src-darcs | Data is downloaded from the source path/URL using ''darcs'' |
-| src-git  | Data is downloaded from the source path/URL using ''git''.  ((If the source contains a semicolon, the portion before the semicolon is treated as a URL and the portion after as a branch name.)) |+| src-git  | Data is downloaded from the source path/URL using ''git''.  ((If the source contains a semicolon, the portion before the semicolon is treated as a URL and the portion after as a branch name.)) ((If the source contains a caret, the portion before the semicolon is treated as a URL and the portion after as a git commit hash))
 +| src-gitsvn | Bidirectional operation between a Subversion repository and git |
| src-hg    | Data is downloaded from the source path/URL using ''hg'' | | src-hg    | Data is downloaded from the source path/URL using ''hg'' |
| src-link  | A symlink to the source path is created | | src-link  | A symlink to the source path is created |
Line 99: Line 102:
  - You create your current project dir ''project''.   - You create your current project dir ''project''.
- 
  - Then while in ''/home/user/openwrt/project''   - Then while in ''/home/user/openwrt/project''
- +    - ''svn co svn://svn.openwrt.org/openwrt/trunk openwrt'' (for the OpenWRT base system) 
-  - ''svn co svn://svn.openwrt.org/openwrt/trunk openwrt'' (for the OpenWRT base system) +   - ''svn co svn://svn.openwrt.org/openwrt/packages packages'' (for the packages feed)
- - ''svn co svn://svn.openwrt.org/openwrt/packages packages'' (for the packages feed) +
  - Add your package in the appropriate subdirectory under ''/home/user/openwrt/project/packages''   - Add your package in the appropriate subdirectory under ''/home/user/openwrt/project/packages''
=== Creating your own feed === === Creating your own feed ===
- 
  - Create your project dir and get trunk, as above   - Create your project dir and get trunk, as above
  - Create your package dir and copy your package into it (e.g. ''cp packagedir /home/user/openwrt/project/customfeed/''), so that your package is under (in this example) ''/home/user/openwrt/project/customfeed/packagedir''   - Create your package dir and copy your package into it (e.g. ''cp packagedir /home/user/openwrt/project/customfeed/''), so that your package is under (in this example) ''/home/user/openwrt/project/customfeed/packagedir''
==== Using the feed ==== ==== Using the feed ====
- 
  - Edit your ''feeds.conf'' (i.e. ''/home/user/openwrt/project/openwrt/feeds.conf'')   - Edit your ''feeds.conf'' (i.e. ''/home/user/openwrt/project/openwrt/feeds.conf'')
  - Add a new line to access the feed (and in the case of adding to the packages feed comment out the normal packages feed.)   - Add a new line to access the feed (and in the case of adding to the packages feed comment out the normal packages feed.)
Line 130: Line 128:
===== Explanations ===== ===== Explanations =====
- 
The downloaded sources (referenced in package Makefiles) are not there... The downloaded sources (referenced in package Makefiles) are not there...
The downloads go first to <buildroot>/dl as gzipped .gz files. And there they are stored and then they get unzipped to /build_dir. See e.g. <buildroot>/build_dir/target-*/ and below it you will find subdirectories for each package's sources. The downloads go first to <buildroot>/dl as gzipped .gz files. And there they are stored and then they get unzipped to /build_dir. See e.g. <buildroot>/build_dir/target-*/ and below it you will find subdirectories for each package's sources.
 +
 +==== Documentation ====
 +  - [[about:toolchain|OpenWrt Buildroot – About]]
 +  - [[doc:howto:buildroot.exigence|OpenWrt Buildroot – Installation]]
 +  - [[doc:howto:build|OpenWrt Buildroot – Usage]]
 +  - OpenWrt Buildroot – Feeds
 +  - [[doc:techref:buildroot|OpenWrt Buildroot – Technical Reference]] {{:meta:icons:tango:48px-construction.svg.png?nolink&16}} this article needs //your// attention.
 +
 +
 +===== Links =====
 +

Back to top

doc/devel/feeds.1368056480.txt.bz2 · Last modified: 2013/05/09 01:41 by orca