User Tools

Site Tools


doc:devel:feeds

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:devel:feeds [2012/11/28 10:15]
danirod
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.
  
-''<​builroot ​dir>/​feeds.conf.default'' ​ ^^^ +As of r41875 the file ''<​buildroot ​dir>/​feeds.conf.default'' ​contains: 
-|src-svn   ​| ​packages ​| %%svn://svn.openwrt.org/​openwrt/​packages%%  | +<file xml feeds.conf.default>​ 
-|src-svn ​  | xwrt     | %%http://​x-wrt.googlecode.com/​svn/​trunk/​package%%  | +src-git packages ​https://github.com/​openwrt/​packages.git 
-|src-svn ​  | luci     | %%http://svn.luci.subsignal.org/luci/trunk/contrib/​package%% ​ | +src-git luci http://git.openwrt.org/​project/​luci.git 
-|#​src-svn ​ | phone    | %%svn://​svn.openwrt.org/​openwrt/​feeds/​phone%% ​ | +src-git routing https://​github.com/openwrt-routing/packages.git 
-|#​src-svn ​ | efl      | %%svn://​svn.openwrt.org/​openwrt/​feeds/​efl%%  | +src-git telephony http://​git.openwrt.org/​feed/​telephony.git 
-|#​src-svn ​ ​| ​desktop ​ | %%svn://​svn.openwrt.org/​openwrt/​feeds/​desktop%%  | +src-git management https://​github.com/​openwrt-management/​packages.git 
-|#​src-svn ​ ​| ​xfce     | %%svn://​svn.openwrt.org/​openwrt/​feeds/​xfce%%  | +#src-git oldpackages http://​git.openwrt.org/​packages.git 
-|#​src-svn ​ ​| ​lxde     | %%svn://​svn.openwrt.org/​openwrt/​feeds/​lxde%%  | +#src-svn xwrt http://​x-wrt.googlecode.com/​svn/​trunk/​package 
-|#​src-link ​custom ​  | /​usr/​src/​openwrt/​custom-feed ​ | +#src-svn ​phone svn://svn.openwrt.org/openwrt/feeds/phone 
- +#​src-svn ​efl svn://​svn.openwrt.org/​openwrt/​feeds/​efl 
-^ ''​Other common feeds''​ ^^^ +#​src-svn ​xorg svn://​svn.openwrt.org/​openwrt/​feeds/​xorg 
-| src-git | packages | %%git://​nbd.name/​packages.git%% | +#src-svn desktop svn://​svn.openwrt.org/​openwrt/​feeds/​desktop 
-| src-git | gargoyle | %%https://​github.com/​ericpaulbishop/​gargoyle%% | +#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>
  
 As of this writing, the following methods are supported: As of this writing, the following methods are supported:
Line 36: 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 101: 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 132: 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 =====
 +
doc/devel/feeds.1354094100.txt.bz2 · Last modified: 2012/11/28 10:15 by danirod