Ipkg
From OESF
(Difference between revisions)
(2 intermediate revisions not shown.) | |||
Line 1: |
Line 1: | ||
| - | + | =Introduction= | |
| - | When you want to install software you normally download an ipkg file or set up some [[Feeds]]. | + | This page aims to tell you everything you ever needed to know about ipkg, the "standard" install file for many Embedded Linux distributions. |
| + | |||
| + | When you want to install software you normally download an ipkg file or set up some [[Feeds]]. Please note, although in this article we call them ipkg files, the usual extension is '''.ipk'''. | ||
* Installation | * Installation | ||
Line 11: |
Line 13: | ||
** [[Pdaxrom: Create An Ipk Howto]] | ** [[Pdaxrom: Create An Ipk Howto]] | ||
| - | + | =Formats= | |
| - | + | ==Sharp== | |
You can gunzip and untar the .ipk file itself, which gives you a few files, including "data.tar.gz", which contains the actual files themselves. Better yet, you can take advantage of Unix pipes, and do this: | You can gunzip and untar the .ipk file itself, which gives you a few files, including "data.tar.gz", which contains the actual files themselves. Better yet, you can take advantage of Unix pipes, and do this: | ||
<code>tar zxvf FILE.ipk ./data.tar.gz | tar tz</code> | <code>tar zxvf FILE.ipk ./data.tar.gz | tar tz</code> | ||
| - | + | ==OPIE== | |
OPIE packages are 'ar' files. 'ar' will be able to unpack an OPIE package, e.g. 'ar -t a_package.ipk'. | OPIE packages are 'ar' files. 'ar' will be able to unpack an OPIE package, e.g. 'ar -t a_package.ipk'. | ||
| - | + | =Troubleshooting= | |
* Corrupt Packages: If a Sharp package is corrupt then gunzip will probably fail to unzip it. | * Corrupt Packages: If a Sharp package is corrupt then gunzip will probably fail to unzip it. | ||
Line 28: |
Line 30: | ||
* Packages not appearing in the list after installing them: Check the package format, or the package itself. This can happen for 3 reasons: | * Packages not appearing in the list after installing them: Check the package format, or the package itself. This can happen for 3 reasons: | ||
*# There are two package formats, one for Sharp ROMs and one for OPIE ROMs. The Sharp package installer can only deal with packages for the Sharp ROMs so make sure you get a Sharp package or a package from a Sharp feed. | *# There are two package formats, one for Sharp ROMs and one for OPIE ROMs. The Sharp package installer can only deal with packages for the Sharp ROMs so make sure you get a Sharp package or a package from a Sharp feed. | ||
| - | *# The package is corrupt. Sometimes a package can get corrupted during download. Some browsers seem to partially unpack packages after downloading. Try redownloading the package again and, if possible, use a different browser to download it. | + | *# The package is corrupt. Sometimes a package can get corrupted during download. Some browsers seem to partially unpack packages after downloading. Try redownloading the package again and, if possible, use a different browser to download it. Run <tt>md5sum file.ipk</tt> to generate the md5 checksum and compare it to the md5 string given in the Packages file for the feed to check for download errors. |
*# The package was not put together properly. The internal structure of a package must follow strict rules, however if you get your packages from reliable feeds and/or software sites you should not have a problem with this. | *# The package was not put together properly. The internal structure of a package must follow strict rules, however if you get your packages from reliable feeds and/or software sites you should not have a problem with this. | ||
* "The file of this package includes characters this application can't handle. Please change the filename and retry install." : The package installer does not like spaces and unusual characters in the directory names, where the package is located, as well. | * "The file of this package includes characters this application can't handle. Please change the filename and retry install." : The package installer does not like spaces and unusual characters in the directory names, where the package is located, as well. | ||
** To correct this, find the parent directory where the packages are located that has a space or unusual character in it using the Files tab. Then, with your stylus, tap and hold down on the directory until a menu appears. Select the 'Rename' menu item and remove the space. | ** To correct this, find the parent directory where the packages are located that has a space or unusual character in it using the Files tab. Then, with your stylus, tap and hold down on the directory until a menu appears. Select the 'Rename' menu item and remove the space. | ||
| - | + | =See Also= | |
* [[Installing a Terminal]] | * [[Installing a Terminal]] | ||
Current revision
Contents |
Introduction
This page aims to tell you everything you ever needed to know about ipkg, the "standard" install file for many Embedded Linux distributions.
When you want to install software you normally download an ipkg file or set up some Feeds. Please note, although in this article we call them ipkg files, the usual extension is .ipk.
- Installation
- How To
Formats
Sharp
You can gunzip and untar the .ipk file itself, which gives you a few files, including "data.tar.gz", which contains the actual files themselves. Better yet, you can take advantage of Unix pipes, and do this:
tar zxvf FILE.ipk ./data.tar.gz | tar tz
OPIE
OPIE packages are 'ar' files. 'ar' will be able to unpack an OPIE package, e.g. 'ar -t a_package.ipk'.
Troubleshooting
- Corrupt Packages: If a Sharp package is corrupt then gunzip will probably fail to unzip it.
- Package was unzipped by browser thinking it was compressed for download. The Files tab in QPE will show an Install icon next to the ipk file but when you tap on it no file appears in the install program. gzip it again and rename it from originalname.ipk.gz to originalname.ipk
- Bus errors: Typically, this is due to a truncated IPK install. If a newly installed application won't run from the Launcher, and you get a 'Bus Error' message when trying to run it from the terminal, it probably got truncated during install, and, unfortunately, the 'Add/Remove Software' application didn't notice. Try uninstalling it, freeing up some space, and then re-installing it.
- Packages not appearing in the list after installing them: Check the package format, or the package itself. This can happen for 3 reasons:
- There are two package formats, one for Sharp ROMs and one for OPIE ROMs. The Sharp package installer can only deal with packages for the Sharp ROMs so make sure you get a Sharp package or a package from a Sharp feed.
- The package is corrupt. Sometimes a package can get corrupted during download. Some browsers seem to partially unpack packages after downloading. Try redownloading the package again and, if possible, use a different browser to download it. Run md5sum file.ipk to generate the md5 checksum and compare it to the md5 string given in the Packages file for the feed to check for download errors.
- The package was not put together properly. The internal structure of a package must follow strict rules, however if you get your packages from reliable feeds and/or software sites you should not have a problem with this.
- "The file of this package includes characters this application can't handle. Please change the filename and retry install." : The package installer does not like spaces and unusual characters in the directory names, where the package is located, as well.
- To correct this, find the parent directory where the packages are located that has a space or unusual character in it using the Files tab. Then, with your stylus, tap and hold down on the directory until a menu appears. Select the 'Rename' menu item and remove the space.
