Ipkg (tutorial)
From DD-WRT Wiki
Revision as of 11:22, 23 July 2005 (edit) Gammelgemse (Talk | contribs) ← Previous diff |
Revision as of 11:27, 23 July 2005 (edit) (undo) Gammelgemse (Talk | contribs) Next diff → |
||
Line 1: | Line 1: | ||
- | + | '''You are here: ''' '''[[Main Page]]'''/'''[[DD-WRT Docu (EN)]]'''/'''[[ipkg]]''' | |
- | ''' | + | |
- | + | ||
+ | =Introduction= | ||
+ | Brainslayer is hard at working merging the code base of DD-WRT with the OpenWRT firmware. This means that, for the most part, OpenWRT's package managment system, ipkg, is available for DD-WRT. This allows for an easy way to add features not already in the DD-WRT firmware. Since ipkg is a command line program, you will need to either [[Telnet/SSH and the Command Line|Telnet or SSH]] into your router to run this utility. | ||
- | + | =Note= | |
- | + | If you have a Wireless G Router, ipkg will not work with Prefinal 4, you need prefinal 5. | |
- | + | ||
+ | =Commandline Structure= | ||
+ | ==Usage== | ||
+ | usage: ipkg [options...] sub-command [arguments...] | ||
+ | ==Options== | ||
+ | <pre>-d <dest_name> or Install, upgrade, or remove package from <dest_name> | ||
+ | -dest <dest_name> where <dest_name> is '''either''' a folder path '''or''' a pre-defined | ||
+ | path in /etc/ipkg.conf | ||
+ | by default, ipkg on DD-WRT supports these pre-defined names: | ||
+ | root /jffs | ||
+ | ram /tmp | ||
+ | -o <offline_root> Use <offline_root> as the root for offline installation. | ||
+ | -offline <offline_root> where <offline_root> is a path | ||
+ | -force-depends Make dependency checks warnings instead of errors | ||
+ | -force-defaults Use default options for questions asked by ipkg. | ||
+ | (no prompts). Note that this will not prevent | ||
+ | package installation scripts from prompting.</pre> | ||
+ | ==Sub Commands== | ||
+ | <pre> | ||
+ | update Update list of available packages from <src> defined in /etc/ipkg.conf | ||
+ | upgrade Upgrade all installed packages to latest version | ||
+ | install <pkg> Download and install <pkg> (and dependencies) | ||
+ | remove <pkg> Remove package <pkg> | ||
+ | list List available packages and descriptions | ||
+ | files <pkg> List all files belonging to <pkg> | ||
+ | search <file> Search for a packaging providing <file> | ||
+ | info [pkg [<field>]] Display all/some info fields for <pkg> or all | ||
+ | status [pkg [<field>]] Display all/some status fields for <pkg> or all | ||
+ | depends <pkg> Print uninstalled package dependencies for <pkg> | ||
+ | - <pkg> may be a package name, or a URI to the *.ipk or *.deb file | ||
+ | - arguments displayed in [ ] are optional | ||
+ | </pre> | ||
+ | =Finding Packages= | ||
+ | [http://www.OpenWrt.org OpenWRT.org] hosts a list of [http://openwrt.org/OpenWrtPackages Official Packages], as well as a [http://nthill.free.fr/openwrt/tracker/packages/ Package Tracker] listing all known packages. Packages from the tracker will usually have to be installed by using <pkg> as a URI rather than a package name, unless you've updated your /etc/ipkg.conf file to point to a different [http://nthill.free.fr/openwrt/tracker/repositories/ repository]. | ||
- | ---- | + | =Installing ipkg packages= |
- | ''' | + | ''The general steps for installing ipkg modules are as follows''<br> |
- | + | -Pick a location to install to. Currently available locations are: <br> | |
+ | '''ram''' (/tmp)<br> | ||
+ | '''root''' (the flash partition at /[[jffs]])<br> | ||
+ | '''mmc''' (/mmc)<br> | ||
+ | '''smbfs''' (/tmp/smbshare)<br> | ||
+ | Then from the [[Telnet/SSH and the Command Line#The DD-WRT Command Line|command line]], run the following commands:<br> | ||
+ | - 'ipkg update' ....pulls latest list of package listing from the default sites.<br> | ||
+ | - 'ipkg list' .....gives the list of ipkg's available<br> | ||
+ | - 'ipkg -d <location> install <packagename>' ....installs the package of your choice <br> | ||
+ | |||
+ | If the package you want is not in the list, substitute the URI of the package for the <packagename> you want to install.<br> | ||
+ | Packages installed to '''ram''' will be deleted on reboot. There is more ram than flash space, however.<br> | ||
+ | [[jffs]] must be configured and initialized before packages can be install to '''root'''<br> | ||
+ | |||
+ | '''Ex:''' to install the noip package to ''ram''<br> | ||
+ | ~# ipkg update | ||
+ | ~# ipkg list | ||
+ | Since noip is not in the list, see [[#Finding Packages|Finding Packages]] | ||
+ | ~# ipkg -d ram install http://www.ramereth.net/openwrt/ipkg/noip_1.6.0_mipsel.ipk | ||
+ | |||
+ | =External Resources= | ||
+ | [http://forum.bsr-clan.de/viewtopic.php?t=1376&sid=91405eea5aa49dc5348a614959010de7 Installing ipkg on DD-WRT] | ||
+ | |||
+ | [http://www.linksysinfo.org/modules.php?name=Forums&file=viewtopic&t=4978 Guide for installing maiu IRC bouncer on the WRT using ipkg] | ||
+ | |||
+ | '''You are here: ''' '''[[Main Page]]'''/'''[[DD-WRT Docu (EN)]]'''/'''[[ipkg]]''' |
Revision as of 11:27, 23 July 2005
You are here: Main Page/DD-WRT Docu (EN)/ipkg
Contents |
Introduction
Brainslayer is hard at working merging the code base of DD-WRT with the OpenWRT firmware. This means that, for the most part, OpenWRT's package managment system, ipkg, is available for DD-WRT. This allows for an easy way to add features not already in the DD-WRT firmware. Since ipkg is a command line program, you will need to either Telnet or SSH into your router to run this utility.
Note
If you have a Wireless G Router, ipkg will not work with Prefinal 4, you need prefinal 5.
Commandline Structure
Usage
usage: ipkg [options...] sub-command [arguments...]
Options
-d <dest_name> or Install, upgrade, or remove package from <dest_name> -dest <dest_name> where <dest_name> is '''either''' a folder path '''or''' a pre-defined path in /etc/ipkg.conf by default, ipkg on DD-WRT supports these pre-defined names: root /jffs ram /tmp -o <offline_root> Use <offline_root> as the root for offline installation. -offline <offline_root> where <offline_root> is a path -force-depends Make dependency checks warnings instead of errors -force-defaults Use default options for questions asked by ipkg. (no prompts). Note that this will not prevent package installation scripts from prompting.
Sub Commands
update Update list of available packages from <src> defined in /etc/ipkg.conf upgrade Upgrade all installed packages to latest version install <pkg> Download and install <pkg> (and dependencies) remove <pkg> Remove package <pkg> list List available packages and descriptions files <pkg> List all files belonging to <pkg> search <file> Search for a packaging providing <file> info [pkg [<field>]] Display all/some info fields for <pkg> or all status [pkg [<field>]] Display all/some status fields for <pkg> or all depends <pkg> Print uninstalled package dependencies for <pkg> - <pkg> may be a package name, or a URI to the *.ipk or *.deb file - arguments displayed in [ ] are optional
Finding Packages
OpenWRT.org hosts a list of Official Packages, as well as a Package Tracker listing all known packages. Packages from the tracker will usually have to be installed by using <pkg> as a URI rather than a package name, unless you've updated your /etc/ipkg.conf file to point to a different repository.
Installing ipkg packages
The general steps for installing ipkg modules are as follows
-Pick a location to install to. Currently available locations are:
ram (/tmp)
root (the flash partition at /jffs)
mmc (/mmc)
smbfs (/tmp/smbshare)
Then from the command line, run the following commands:
- 'ipkg update' ....pulls latest list of package listing from the default sites.
- 'ipkg list' .....gives the list of ipkg's available
- 'ipkg -d <location> install <packagename>' ....installs the package of your choice
If the package you want is not in the list, substitute the URI of the package for the <packagename> you want to install.
Packages installed to ram will be deleted on reboot. There is more ram than flash space, however.
jffs must be configured and initialized before packages can be install to root
Ex: to install the noip package to ram
~# ipkg update ~# ipkg list
Since noip is not in the list, see Finding Packages
~# ipkg -d ram install http://www.ramereth.net/openwrt/ipkg/noip_1.6.0_mipsel.ipk
External Resources
Guide for installing maiu IRC bouncer on the WRT using ipkg
You are here: Main Page/DD-WRT Docu (EN)/ipkg