Note regarding Build servers

As of 2010-Oct-26, the official builder is still on Ubuntu 8.04.3 LTS.

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/apps/trac/sourceforge/wiki/Subversion) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake, automake1.9, sudo, patch, bzip2, gzip, wget, sed, texinfo, subversion and while your at it, your favourite editor e.g. emacs.

Note, if you are wanting to build for nslu2 (unslung), Ubuntu 9.10 cannot be used, as GCC 3.3 is needed (3.4 may suffice). Debian 5 still has this in its package feeds.

  $ cd <platform>; make directories toolchain ipkg-utils

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake, automake1.9, sudo, patch, bzip2, gzip, wget, sed, texinfo, subversion and while your at it, your favourite editor e.g. emacs.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake, automake1.9, sudo, patch, bzip2, gzip, wget, sed, texinfo and while your at it, your favourite editor e.g. emacs.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed, texinfo and while your at it, your favourite editor e.g. emacs.

Now it's time for the moment of truth. From your optware/<target> (<target> being the optware target) make your package.

Note regarding Libtool and Libtoolize

For building most packages, the GNU Libtool and Libtoolize are essential programs that need to be installed on the build system. These two programs interact with the ltmain.sh script included with most program tarballs. There are currently two version streams for these programs, version stream 1.5.x included with most older versions of Debian and Ubuntu etc, this is the version used by the NSLU2 Optware build machines. More recent versions of Ubuntu and other Linux distros have now upgraded Libtool and Libtoolize to the version stream 2.2.x. Unfortunately many Optware packages will not build with this later version. The reason - version stream 2.2.x is not fully backwardly compatible with ltmain.sh scripts from earlier versions. This backward compatibility problem is well documented on the internet, there are may recommended fixes and patches etc, most are not fully explored, some may fix one package but break another. To check the version of Libtool installed type at a console prompt : -

libtool --version

For Optware development it is recommended that the version of Libtool is downgraded to version 1.5.26 or lower, example - with a Ubuntu Intrepid build system install the Ubuntu Hardy version of the libtools.

Another possibility is to upgrade the version of the ltmain.sh script included with the program tarball to a version 2.2.x. This seems to work with some program tarballs but not all.

December 2008

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

cool girls ;) <a href=" http://groups.google.us/group/teensss ">teentonic</a>

great boobs dude )) see <a href=" http://groups.google.us/group/sexyboobs ">sexycouple</a>

sweet babes )) <a href=" http://groups.google.us/group/sexyboxy ">asexstories</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

dfgdfgdfsgsd gdsfgdsf gdsfgdsf gdsfg <a href=" http://groups.google.us/group/teensxx ">whiteteensblackcocks</a>

nice site man <a href=" http://groups.google.us/group/replicax ">replica louis vuitton diaper bag</a>

great site dude <a href=" http://groups.google.us/group/replicaz ">rolex replicas</a>

cool work thanks <a href=" http://groups.google.us/group/ringtonesn ">free monophonic midi ring tones htm</a>

hello good links thx <a href=" http://groups.google.us/group/ringtoneso ">free cingular mono ring tones htm</a>

sfsadf fsdafas fdasf asdf <a href=" http://groups.google.us/group/ringtonesp ">free ring tones and images htm</a>

hi nice site thx <a href=" http://groups.google.us/group/replica-watches-yx ">replica watches</a> 222177

hello everybody! <a href=" http://groups.google.us/group/replica-watches-wx ">swiss made breitling replica watches</a> =)))

dfgdsfg gdfgdsfg gsdfgdsfg dsfgdsf g<a href=" http://groups.google.us/group/ringtonesm ">free polyphonic ring tones</a>

interesting post thx <a href=" http://groups.google.us/group/replica-watches-tx ">vacheron constantin replica watches</a> 510824

hello everybody! <a href=" http://groups.google.us/group/replica-watches-qx ">cheap replica rolex watches</a> 01633

hgfhgf hgfhdfg hgfhfgh gfh <a href=" http://groups.google.us/group/ringtonesj ">ring tones sidekick send as text free</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

hi great site 10x <a href=" http://groups.google.us/group/replica-watches-ex ">montblanc replica watches</a> 047

it's nice site <a href=" http://groups.google.us/group/replica-watches-kx ">louis vuitton replica watches</a> =-)

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

dgfgds gfdgds gdsfgdsf gdfsgsd <a href=" http://groups.google.us/group/ringtonesii ">ringtones_download_polyphonic_audiovox_htm</a>

sdfdasf dsffsadf sdfasdf dsfasd <a href=" http://groups.google.us/group/ringtonesf ">free_country_ringtones_verizon_htm</a>

gdfgds gdfgdsf gfdsgdsf gdsfgds <a href=" http://groups.google.us/group/ringtonesg ">snap rhythm is a dancer real ringtones</a>

dfgdsfg gsdfgdsf gdsfgdsf gdsfgdsf gdsfg <a href=" http://groups.google.us/group/ringtonesh ">ringtones from disney movies</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

gfdgsd gdsfgdsfg gsfdgdsfg gsdfgdsfg <a href=" http://groups.google.us/group/ringtonese ">farm anuimal ringtones</a>

dfgdsfg dgsfgdsfg sdfgdsfg <a href=" http://groups.google.us/group/ticketsonline ">panthers tickets</a>

fdsfsda fdsfdasf fdsafdasf fdasfdasf <a href=" http://groups.google.us/group/ringtonesd ">verizon wireless motorola v60p ringtones</a>

dfsgdsfg dsfgdsg dsfgdsfg sdfg <a href=" http://groups.google.us/group/airfarez ">number of people on welfare</a>

fasdfasd fdasfasdfas fasdfasdf asfdfsd f<a href=" http://groups.google.us/group/ringtonesz ">shotgun messiah lg l1200 ringtones</a>

dgdsfg gfdsgdsf gdsfgdsfgds gdsfgds <a href=" http://groups.google.us/group/ticketssz ">ticketmaster outlets</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

jhhb hyuh uihui ijui <a href=" http://groups.google.us/group/ringtonesc ">pay ringtone paypal</a>

gdfgdsf gfdgdsfgdsf dsfgdsf <a href=" http://groups.google.us/group/zairfare ">cheap airfares porto velho</a>

i say one thing <a href=" http://groups.google.us/group/replica-vuitton-nn ">cheap louis vuitton replica</a> >:]]]

it's nice site <a href=" http://groups.google.us/group/replica-vuitton-xy ">suhali handbag louis vuitton replica</a> >:(((

cool post dude <a href=" http://groups.google.us/group/replica-vuitton-xlx ">louis vuitton man wallet replica</a> klrdnq

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

gfhfgh hdfgh dfghdgfhdf hdgfh <a href=" http://groups.google.us/group/rolexx ">rolex authorized service centers</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

gdsfggfhjdsfggh gdsfgdsf <a href=" http://groups.google.us/group/xairfare ">the seafarer</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

cool see you <a href=" http://groups.google.com/group/ringtonesp ">kids only ring tone</a>

awesome site thx <a href=" http://groups.google.com/group/ringtonesn ">ring tones for business free</a>

really work man wow <a href=" http://groups.google.com/group/replicaz ">replica classic motor carriages</a>

yes interesting site thx <a href=" http://groups.google.com/group/ringtoneso ">free motorola c343 ring tones</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

i love this site )) <a href=" http://groups.google.com/group/ringtonesl ">unified tribe ring tone</a>

cool post man <a href=" http://groups.google.com/group/ringtonesj ">create nextel ring tones</a>

sweet post dude )) i love you <a href=" http://groups.google.com/group/ringtonesii ">senators ringtone</a>

hi it's jessy cool )) <a href=" http://groups.google.com/group/ringtonesf ">free poly ringtone downloads data link cable</a>

good work great site =) <a href=" http://groups.google.com/group/ringtonesh ">ringtones_for_telus_phones_htm</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

interesting site man thx... <a href=" http://groups.google.com/group/ringtonesg ">cingular download download free ringtone ringtone ringtone</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

nice site dude 10x <a href=" http://groups.google.com/group/ringtonesb ">wallpapers_cingular_ringtones_and_graphics_htm</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

good links thx <a href=" http://groups.google.com/group/rolexx ">buy rolex</a>

great work bookmark you <a href=" http://groups.google.com/group/ringtonesz ">cheap nokia ringtones</a>

thanks good <a href=" http://groups.google.com/group/rolexz ">how to value a rolex</a>

cool post 10x <a href=" http://groups.google.com/group/ticketsz ">steelers tickets</a>

sweet site thanks <a href=" http://groups.google.com/group/ticketssz ">teener ticket</a>

hi it's mona cool ;) <a href=" http://groups.google.com/group/ticketsonline ">cheap tickets to melbourne australia</a>

good work nice site <a href=" http://groups.google.com/group/ticketsss ">name your price airlane tickets</a>

cool site thx <a href=" http://groups.google.com/group/xairfare ">discount air fare</a>

hi nice work man <a href=" http://groups.google.com/group/ztickets ">cheap airplane tickets</a>

great work cool site 10x <a href=" http://groups.google.com/group/airfarez ">cfares</a>

interesting post thx <a href=" http://groups.google.com/group/zairfare ">debrah farentino</a>

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

i say one thing <a href=" http://groups.google.us/group/watch-upskirt-me ">upskirt tokyo</a> kmbep

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

it's nice site <a href=" http://groups.google.us/group/upskirt-nu ">beyonce upskirt</a> wqxzq

nice work man 10x

hay <a href=" http://groups.google.us/group/upskirt-video-x ">spears upskirt</a> 630727

nice work man 10x

You have a program you would like to add to the packages area?

Here are the steps necessary.

1. Understand why we are doing the packaging efforts.
2. Check out your own copy of packages source tree.
3. Create your first own package.
4. Request SVN developer access.
5. Check in your package with your commit comments.
6. Mark it as ready for testing.

Software Packaging Overview

You must have SVN access to the packages source tree. If you have questions about SVN, the instructions at SourceForge (http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1) are quite helpful. NSLU2 SVN is available on the web at http://svn.nslu2-linux.org/svnroot/optware

• To build and test your new application you will only need anonymous read access
• Saving your changes requires you to have developers access.

Note that packages are normally built on a HOST machine (like a desktop or laptop) running Linux. Some people compile natively on the NSLU2.

You should wait until you have compiled and tested your application before requesting write access. Once you have downloaded the development tools and package sources, and successfully built Unslung and all the packages, you are ready to add your own package.

To get SVN write permission so you can add your package to the Optware distribution, send your request to the developers mailing list (Join nslu2-developers on Yahoo Groups then send an email to nslu2-developers@yahoogroups.com) requesting SVN write access, with the .mk file and any other associated source files as an attachment, and you will normally be given SVN write access as soon as an admin sees it. Note that we will not add the package for you - the reason for sending it to the list is so you can be approved for SVN write access - you will still have to check in the package to SVN yourself. Furthermore, as a registered SVN developer, you must be entered into the Trac bug tracking system at http://trac.nslu2-linux.org/ as a developer and every package you add must be added too.

If you are cross-compiling on a normal Linux desktop or laptop (this is the preferred option for packages that can be cross-compiled) then the build system will compile the crosstool package for you, so you don't need to build it yourself any more. If you are native compiling, then see NativelyCompileUnslungPackages for details of the native compilation toolchain. Native package building should be possible from beginning to end using the following instructions.

Check out package sources from svn.nslu2-linux.org

Checking out package sources before you have SVN write access

First, you need to copy the SVN tree.

   cd /home/slug/         (you can use whatever directory you want, of course)
   svn co http://svn.nslu2-linux.org/svnroot/optware/trunk optware

This will create an optware directory with the whole svn tree. Inside optware/make is our guiding template.mk file. template.mk makes life much, much easier as we only have to edit this file to ensure everything builds properly. For the purpose of the remainder of this article, I'm going to call the package we're building mypackage.

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

If you are using a recent version of Ubuntu, the default shell will not allow the toolchain to compile (errors like "csu/version-info.h:1: error: missing terminating " character"), type ls -la /bin/sh and if the result points to dash, then type sudo dpkg-reconfigure dash or simply sudo ln -sf /bin/bash /bin/sh to change the shell. With dash as /bin/sh, it sometimes causes optware perl build to stop with 'You haven't done a "make depend" yet!' error message.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

Developer (with SVN write access) way of checking out package sources

• Request and be approved for SVN write access - you will be sent an NSLU2-Linux SSL client certificate
• Use SVN to check out the optware distribution:

 
      $ svn co https://svn.nslu2-linux.org/svnroot/optware/trunk optware

Building the ipkg package

The ipkg package is needed as part of building your own packages. Do the following:

  $ cd optware; make <platform>-target
  $ cd <platform>; make directories ipkg-utils

Where <platform> can be one of nslu2, cs05q3armel, etc. See optware/platforms/ for available targets.

Guidelines for package developments

There is work in progress to show which practices have shown to be successful and therefor encouraged, and which aren't. Go to PackagingBestPractices to see these and add your own commments.

An especially important rule is that all packages must be able to be rebuilt from source from the SVN repository. We do not accept binary-only packages in the official Optware package repository (however, we are happy to point to other third-party repositories).

You might also find it helpful to know how our build machines are set up. This information can be found at:

• Info.NativeBuildMachine for official native build machine (an NSLU2 dedicated to building optware native packages)
• Info.CrossBuildMachine for official cross build machine (a PC)

Making a package using the template

   cp make/template.mk make/mypackage.mk

Now comes the bulk of our work -- editing mypackage.mk. Probably you could simply follow the directions in that file and be quite successful, but I'll go through the process is a bit more detail. Two variables in mypackage.mk can be replaced quite quickly -- these are big <FOO> and little <foo>. Big <FOO> and little <foo> need to be replaced with your package name in capital and lower case respectively. We can do this quickly with:

   sed -i 's/<FOO>/MYPACKAGE/g' make/mypackage.mk
   sed -i 's/<foo>/mypackage/g' make/mypackage.mk

Or use make make/mypackage.mk as a shortcut of the above.

   mkdir sources/mypackage

Edit mypackage.mk with our package specific variables. Open your favorite editor, and look for MYPACKAGE_SITE. This variable needs to be set to the url (usually ending in "download") where your package's source may be found. wget will try to download your package from $(MYPACKAGE_SITE)/$(MYPACKAGE_SOURCE) -- so set MYPACKAGE_VERSION as well. If your file is bzipped, set MYPACKAGE_UNZIP=bzcat, otherwise leave that variable alone.

For the remainder of the editing process follow the directions in mypackage.mk. For the packages I've worked on there are no patches so I commented out references to patch.

The template.mk file assumes that you will be downloading your package's source in tarball format. If for some reason you must download it with cvs or some other revision control tool, you should start with template-cvs.mk instead. Only do this if you have tried and failed to find a usable tarball.

The optware/sources/mypackage directory can also contain files for actions to take after installation (postinst), any init tabs your package might need (rc.mypackage), and any other files that your package might need (note: if you don't know of any, there probably aren't any -- as an example, the bash package installs profile). If your package doesn't have any postinstall or init files, you should comment out the appropriate lines in the (MYPACKAGE_IPK) section of mypackage.mk.

Now it's time for the moment of truth. From your optware svn root (e.g. /share/hdd/data/src/optware) make your package.

   make mypackage      (this compiles your package)
   make mypackage-ipk  (this makes your package and the ipk)
   make mypackage-check  (this does some sanity check of your new ipk)

You may get errors; try to determine whether the error is occuring due to the makefile (i.e. mypackage.mk) or due to problems in your source program. If you have problems, you can probably find help, or at least sympathy, on IRC.

If you get an error during compilation that says keramik is not found, unset STYLE and try again. Keramik sets the STYLE variable which is also used by some packages.

If you want to know the value of any optware make variable, you can "make query-VAR_NAME" (very useful).

If you get an error building the ipk that tar doesn't recognise the --format option you need to upgrade to a newer version of GNU tar (at least 1.14). If you are running Suse 9.1 it is possible to uninstall the standard rpm (ignoring any dependency violations) and install the rpm from Suse 9.2. Similar tricks may be possible on other distros but make sure you have got the original package available to reinstall if needed.

Error Example 1: "copy and paste" was performed from above instructions to get following error message. www.mypackage.org is a fake one, it should be replaced with a real address and so as "mypackage" pacakge name.

[tjyang@dual optware]$ make mypackage
wget --passive-ftp -P /export/home/tjyang/slug/optware/downloads
http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
--21:32:51-- http://www.mypackage.org/downloads/mypackage-3.2.3.tar.gz
=> `/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz'
Resolving www.mypackage.org... failed: Host not found.
make: *** [/export/home/tjyang/slug/optware/downloads/mypackage-3.2.3.tar.gz] Error 1
[tjyang@dual optware]$
Once you have it compiling, try those commands again. Nothing should happen (as everything should be up to date). If you find that things are being rebuilt, then it means that the dependencies in your mypackage.mk are not correct - you will need to fix them before your package will be accepted into the official repository.

Once you have your ipk, try to install it (ipkg install /path/to/mypackage). If everything seems to be working, write your project back to svn (and remember, you have to have write access to svn). Update the Packages page with your new package.

Check in your package sources to svn.nslu2-linux.org

• remember to put in commit comments as described here: http://www.nslu2-linux.org/wiki/Development/CommitGuidelines
• svn add <your new files>
• svn commit -m "package: brief description of new package, initial addition"

Mark your package ready for testing

When your package is ready to be looked at by a core developer, add its name to one of the READY_FOR_TESTING lines in the root Makefile. In due course, someone will take a look at what you've done. If it works, and follows the Unslung.PackagingBestPractices, it will be uploaded to the feed. If not, it will be moved to a NEED_TO_BE_FIXED line, and a comment entered in the makefile describing the problem.

  svn lock Makefile
  <edit the Makefile to add your lines>
  svn commit -m "package: comments as per guidelines" Makefile

If you are requesting native compilation for your package, please add a comment to the Makefile explaining concisely why the package cannot be cross-compiled. The process for this is:

You would be well advised to be on the #nslu2-linux irc channel when you do SVN commits, especially when you make your package READY_FOR_TESTING. That way you will get realtime comments from other developers.

References

1. For more information about the IPKG Package Management System, take a look at http://www.handhelds.org/moin/moin.cgi/Ipkg
2. For SVN introduction, please see https://sourceforge.net/docs/E04/
3. A nice overview howto by jeanfabrice is here: http://wl500g.info/showpost.php?p=14309&postcount=4

Good luck with NSLU2 development!

If you see something unclear in this description, please be sure to update it.

ue2tIc

Quick build notes: If you have not yet got a linux build system you can use windows, see below. If you type make in /home/slug/optware then the cross compilation tools along with every package will be fetched and built -- this takes a long time and is likely to break over a missing system package or old hyperlink. If you just want to build the cross compilation tools and obtain a set up that will allow you to build your own packages then take a look in the Makefile, pick a small utility of interest from the package list such as make/which.mk, execute the commands listed below in the section 'Building the ipkg package' and type make <utility>. Once its built, have a look at optware/make/<utility>.mk, compare with optware/make/template.mk and follow the section 'Making a package using the template' to start building your own packages.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc, cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install VirtualBox? (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc (this wil also install gcc-3.3), cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.

New (windows) build system: If you are starting from scratch with a windows box then the easiest route is install "VirtualBox?" (http://www.virtualbox.org/) and then install a version of linux into that, pick your favourite but I used Ubuntu 7.10. Create a machine with at least 6Gb of hard disc. You will need to install some packages to build with: apt-get install <package> the following packages: gcc (this wil also install gcc-3.3), cvs, flex, bison, make, pkg-config, rsync, gettext, libglib2.0-dev, autoconf, libtool, automake1.9, sudo, patch, bzip2, gzip, wget, sed and while your at it, your favourite editor e.g. emacs.