cksum » OpenWrt http://cksum.org/blog 3778944472 1484352 /vmlinuz Tue, 24 Jan 2012 13:22:42 +0000 en hourly 1 http://wordpress.org/?v=3.3.1 Création d’un patch pour la mise à jour d’un paquet OpenWrt http://cksum.org/blog/157-creation-patch-mise-a-jour-paquet-openwrt http://cksum.org/blog/157-creation-patch-mise-a-jour-paquet-openwrt#comments Wed, 02 Nov 2011 13:05:49 +0000 raphaelh http://cksum.org/blog/?p=157 Nous allons voir comment mettre à jour le paquet pcre de la version 8.11 vers la version 8.20, et comment créer un patch pour l’envoyer aux développeurs d’OpenWrt.

Pour info, voici l’arborescence dans laquelle je travaille :

$ ls /data/workspace/openwrt/
patches  trunk

Tout d’abord, nous allons faire en sorte d’être à jour :

$ cd /data/workspace/openwrt/trunk/
$ svn up
$ ./scripts/feeds update -a

Nous sommes maintenant prêts à commencer.

On commence par télécharger la dernière version de pcre dans le répertoire dl/ :

$ wget -P dl/ ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-8.20.tar.bz2

Puis on calcule sa somme de contrôle MD5 :

$ md5sum dl/pcre-8.20.tar.bz2 
a1931c70e1273e3450d5036fe273d25c  dl/pcre-8.20.tar.bz2

On va alors dans le répertoire du paquet pour commencer à travailler :

$ cd feeds/packages/libs/pcre/

On indique à quilt de créer un nouveau patch :

$ quilt new pcre.patch
Patch pcre.patch is now on top

On lui indique qu’on veut modifier le fichier Makefile, ce qui aura pour effet de l’ajouter automatiquement au patch qui est au sommet de la pile :

$ quilt edit Makefile 
File Makefile added to patch pcre.patch

On va donc mettre à jour les divers paramètres du paquet qui ont changé.

Dans tous les cas il y aura PKG_VERSION à changer pour mettre le nouveau numéro de version, PKG_RELEASE à mettre à 1 (car c’est la première release du paquet à la nouvelle version), et PKG_MD5SUM à mettre à la valeur calculée un peu plus tôt.

Dans cet exemple, PKG_SOURCE_URL change également.

Avant :

PKG_NAME:=pcre
PKG_VERSION:=8.11
PKG_RELEASE:=2
 
PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.bz2
PKG_SOURCE_URL:=@SF/pcre
PKG_MD5SUM:=ef907b8792ec7f90f0dcd773848f0b3b

Après :

PKG_NAME:=pcre
PKG_VERSION:=8.20
PKG_RELEASE:=1
 
PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.bz2
PKG_SOURCE_URL:=ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/
PKG_MD5SUM:=a1931c70e1273e3450d5036fe273d25c

Une fois les modifications effectuées, on indique à quilt de rafraîchir le patch :

$ quilt refresh
Refreshed patch pcre.patch

Comme nous l’avons défini dans Installation et configuration de quilt pour créer des patchs OpenWrt, le patch se trouve dans /data/workspace/openwrt/patches/.

On retourne à la racine d’OpenWrt pour vérifier que tout compile correctement :

$ cd -
/data/workspace/openwrt/trunk
 
$ make package/pcre/compile V=99 DEVELOPER=1

Et voilà !

]]> http://cksum.org/blog/157-creation-patch-mise-a-jour-paquet-openwrt/feed 0 Les listes de discussion OpenWrt http://cksum.org/blog/260-listes-discussion-openwrt http://cksum.org/blog/260-listes-discussion-openwrt#comments Thu, 13 Oct 2011 10:04:13 +0000 raphaelh http://cksum.org/blog/?p=260 Il y a actuellement 3 listes de discussion (mailing lists) OpenWrt actives et publiques :

Les liens ci-dessus permettent de s’inscrire aux différentes listes, et également de consulter les archives.

La liste openwrt-devel est la plus intéressante pour ceux qui font du développement sous OpenWrt, et c’est d’ailleurs le moyen privilégié pour contribuer un patch.

Ces listes sont anglophones, mais il existe également un forum OpenWrt en français.

]]> http://cksum.org/blog/260-listes-discussion-openwrt/feed 1 Paquet OpenWrt : la variable PKG_MIRROR_MD5SUM http://cksum.org/blog/190-paquet-openwrt-variable-pkg_mirror_md5sum http://cksum.org/blog/190-paquet-openwrt-variable-pkg_mirror_md5sum#comments Wed, 05 Oct 2011 13:03:20 +0000 raphaelh http://cksum.org/blog/?p=190 La variable PKG_MIRROR_MD5SUM a été ajoutée lors du commit [26260].

Une petite explication est nécessaire avant d’aborder cette variable. Dans le Makefile d’un paquet OpenWrt, la variable PKG_SOURCE_URL, comme son nom l’indique, spécifie l’URL à partir de laquelle les sources du paquet seront téléchargées. Différentes méthodes sont prises en charge, HTTP, FTP, git, subversion,… Dans les cas HTTP et FTP, c’est une archive (*.tar.bz2, *.tar.gz, *.zip,…) qui sera téléchargée, mais lorsqu’il s’agit d’un dépôt (git, subversion…), c’est un checkout qui sera effectué.

Dans ce dernier cas, OpenWrt va automatiquement créer une archive dans le répertoire dl/ (qui contient toutes les archives téléchargées) à partir du checkout. Cette archive aura le nom défini par la variable PKG_SOURCE.

Prenons un exemple avec le Makefile du paquet hostapd, dont voici un extrait :

PKG_NAME:=hostapd
PKG_VERSION:=20110527
PKG_RELEASE:=2
PKG_REV:=ceb34f250af7a7082f18c1e0451dc7fbc0f000f3
 
PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.bz2
PKG_SOURCE_URL:=git://w1.fi/srv/git/hostap.git
PKG_SOURCE_SUBDIR:=$(PKG_NAME)-$(PKG_VERSION)
PKG_SOURCE_VERSION:=$(PKG_REV)
PKG_SOURCE_PROTO:=git
PKG_MIRROR_MD5SUM:=4b98902d782813b41aca1faff613f677

hostapd est téléchargé à partir du dépôt git://w1.fi/srv/git/hostap.git. OpenWrt va automatiquement créer l’archive hostapd-20110527.tar.bz2 dans le répertoire dl/, qu’on peut mettre sur un miroir, afin qu’OpenWrt télécharge les sources directement sous forme d’archive, plutôt que de faire un checkout.

On peut vérifier, en gardant l’exemple du paquet hostapd, que la somme de contrôle MD5 de l’archive correspond bien à la valeur de PKG_MIRROR_MD5SUM définie dans le Makefile :

$ md5sum dl/hostapd-20110527.tar.bz2 
4b98902d782813b41aca1faff613f677  dl/hostapd-20110527.tar.bz2

Voici maintenant comment spécifier un miroir :

$ make menuconfig

Ensuite on sélectionne :

[*] Advanced configuration options (for developers)  --->

Puis :

()    Local mirror for source packages

Il suffit alors d’entrer l’adresse d’un serveur HTTP ou FTP :

et finalement quitter menuconfig en enregistrant la nouvelle configuration.

]]> http://cksum.org/blog/190-paquet-openwrt-variable-pkg_mirror_md5sum/feed 0 Openwrt : le fichier feeds.conf http://cksum.org/blog/167-openwrt-fichier-feeds-conf http://cksum.org/blog/167-openwrt-fichier-feeds-conf#comments Tue, 13 Sep 2011 13:33:44 +0000 raphaelh http://cksum.org/blog/?p=167 La liste des flux de paquets utilisables est définie dans un fichier nommé feeds.conf qui se trouve à la racine des sources OpenWrt. L’utilitaire ./scripts/feeds tente d’abord de lire le fichier feeds.conf, et s’il n’existe pas, c’est le fichier feeds.conf.default qui sera pris en compte. Voici son contenu par défaut :

src-svn packages svn://svn.openwrt.org/openwrt/packages
src-svn xwrt http://x-wrt.googlecode.com/svn/trunk/package
src-svn luci http://svn.luci.subsignal.org/luci/trunk/contrib/package
#src-svn phone svn://svn.openwrt.org/openwrt/feeds/phone
#src-svn efl svn://svn.openwrt.org/openwrt/feeds/efl
#src-svn desktop svn://svn.openwrt.org/openwrt/feeds/desktop
#src-svn xfce svn://svn.openwrt.org/openwrt/feeds/xfce
#src-svn lxde svn://svn.openwrt.org/openwrt/feeds/lxde
#src-link custom /usr/src/openwrt/custom-feed

La syntaxe est très simple : une définition de flux correspond à une ligne, constituée de 3 champs séparés par des espaces. Ces champs sont, dans l’ordre :

  • méthode : la méthode à utiliser pour copier ou télécharger les données du flux (voir un peu plus loin les différentes valeurs possibles)
  • nom : le nom utilisé pour identifier un flux, et créer les divers répertoires et fichiers qui contiennent les données de ce flux
  • source : l’emplacement (chemin d’accès ou URL) à partir duquel les données du flux seront copiées ou téléchargées

Les lignes commençant par le caractère # sont ignorées.

Voici les différentes méthodes supportées actuellement :

  • src-cpy : les données sont copiées à partir d’un répertoire source
  • src-link : un lien symbolique est créé vers le répertoire source
  • src-svn : les données sont récupérées à partir d’un dépôt Subversion
  • src-git : les données sont récupérées à partir d’un dépôt git
  • src-gitsvn : les données sont récupérées avec git à partir d’un dépôt Subversion
  • src-bzr : les données sont récupérées à partir d’un dépôt Bazaar
  • src-hg : les données sont récupérées à partir d’un dépôt Mercurial
  • src-darcs : les données sont récupérées à partir d’un dépôt Darcs

Remarques :

  • Pour la méthode src-cpy, le nom du flux doit être identique au nom du répertoire contenant le flux (c’est-à-dire le basename de la source).
  • Il est possible de spécifier un nom de branche pour la méthode src-git : si la source contient le caractère ; (point-virgule), la partie avant le point-virgule est traitée comme une URL et la partie après comme un nom de branche.
  • Pour les méthodes src-git et src-bzr, l’historique complet n’est pas téléchargé : git clone est appelé avec le paramètre –depth 1 et bzr checkout avec le paramètre –lightweight. Si ce n’est pas le comportement souhaité, il faut modifier le fichier ./scripts/feeds.
]]> http://cksum.org/blog/167-openwrt-fichier-feeds-conf/feed 0 Récupération et mise à jour des sources d’OpenWrt avec subversion http://cksum.org/blog/159-recuperation-mise-a-jour-sources-openwrt-subversion http://cksum.org/blog/159-recuperation-mise-a-jour-sources-openwrt-subversion#comments Tue, 13 Sep 2011 08:51:14 +0000 raphaelh http://cksum.org/blog/?p=159 Voici comment récupérer les sources de développement d’OpenWrt avec subversion.

Cette étape initiale prend un certain temps (mais moins qu’avec git), sur mon PC ça a pris environ 3 minutes :

$ svn co svn://svn.openwrt.org/openwrt/trunk/ openwrt

Les sources se trouvent alors dans le répertoire openwrt/ :

$ ls openwrt/
BSDmakefile  Config.in  docs  feeds.conf.default  include  LICENSE  Makefile  package  README  rules.mk  scripts  target  toolchain  tools

Et quand on veut mettre à jour les sources :

$ cd openwrt/
$ svn up

A la révision 28226, cela prend un total de 217M sur mon disque dur.

]]> http://cksum.org/blog/159-recuperation-mise-a-jour-sources-openwrt-subversion/feed 0 Récupération et mise à jour des sources d’OpenWrt avec git http://cksum.org/blog/155-recuperation-mise-a-jour-sources-openwrt-git http://cksum.org/blog/155-recuperation-mise-a-jour-sources-openwrt-git#comments Tue, 13 Sep 2011 08:37:04 +0000 raphaelh http://cksum.org/blog/?p=155 Pour ceux qui préfèrent utiliser git que subversion, il existe le dépôt git://nbd.name/openwrt.git, qui est un clone de svn://svn.openwrt.org/openwrt/trunk/.

Cette étape initiale prend un certain temps, sur mon PC ça a pris environ 15 minutes :

$ git clone git://nbd.name/openwrt.git
Cloning into openwrt...
remote: Counting objects: 180065, done.
remote: Compressing objects: 100% (59223/59223), done.
remote: Total 180065 (delta 118121), reused 170795 (delta 111287)
Receiving objects: 100% (180065/180065), 78.81 MiB | 122 KiB/s, done.
Resolving deltas: 100% (118121/118121), done.

Les sources se trouvent alors dans le répertoire openwrt/ :

$ ls openwrt/
BSDmakefile  Config.in  docs  feeds.conf.default  include  LICENSE  Makefile  package  README  rules.mk  scripts  target  toolchain  tools

Et quand on veut mettre à jour les sources :

$ cd openwrt/
$ git pull
]]> http://cksum.org/blog/155-recuperation-mise-a-jour-sources-openwrt-git/feed 0 French ISP SFR publishes OpenWrt sources of its DSL modem http://cksum.org/blog/39-french-isp-sfr-publishes-openwrt-sources-dsl-modem http://cksum.org/blog/39-french-isp-sfr-publishes-openwrt-sources-dsl-modem#comments Tue, 27 Apr 2010 14:32:28 +0000 raphaelh http://cksum.org/blog/?p=39 Logo EfixoThe neufbox 4 is a BRCM63xx based DSL router the french ISP SFR provides to its customers, and more than 3 million units are currently in use. The device is developed by Efixo and the OpenWrt based sources are available through a subversion repository and documentation is placed in a Trac wiki.

Efixo has shown a commitment for openness and have in the past been providing development sources.neufbox 4

Some sources are not directly available, but proprietary binary drivers are downloaded and integrated in the firmware during the default build process. Now, everyone can checkout the OpenWrt based sources, compile and install a firmware version which includes complete services, such as VoIP and television.


~$ svn co http://svn.efixo.net/trunk/ neufbox
~$ cd neufbox/
~$ make nb4-main

Further details (mainly in french) can be found in the unofficial neufbox 4 community, which offers information on how to build a serial JTAG, how to reflash the neufbox 4 and more.

]]> http://cksum.org/blog/39-french-isp-sfr-publishes-openwrt-sources-dsl-modem/feed 0 OpenWrt packages: the TITLE field http://cksum.org/blog/11-openwrt-packages-title-field http://cksum.org/blog/11-openwrt-packages-title-field#comments Tue, 09 Feb 2010 16:46:58 +0000 raphaelh http://cksum.org/blog/?p=11 In OpenWrt, the default values for fields concerning a package are defined in /trunk/include/package-defaults.mk.

You can see that for the TITLE field, the default is the empty string:
TITLE:=

So you need to define it in your package Makefile. Let’s take the Makefile of liblzo as an example:

define Package/liblzo
SECTION:=libs
CATEGORY:=Libraries
TITLE:=A real-time data compression library
URL:=http://www.oberhumer.com/opensource/lzo/
endef

After doing a make menuconfig, and navigating to the liblzo package, it will show this:

OpenWrt menuconfig for liblzo package

Okay, pretty simple. Now what is the maximum length possible for this field?

The TITLE field can be up to 65 characters in length:

define Package/liblzo
SECTION:=libs
CATEGORY:=Libraries
TITLE:=abcdefghijklmnopqrstuvwxyz0123456789abcdefghijklmnopqrstuvwxyz012
URL:=http://www.oberhumer.com/opensource/lzo/
endef

This will show:

OpenWrt menuconfig for liblzo package (66 characters TITLE)OpenWrt menuconfig for liblzo package (66 characters TITLE)

But if you add one more character, the TITLE field will now be 66 characters long:

define Package/liblzo
SECTION:=libs
CATEGORY:=Libraries
TITLE:=abcdefghijklmnopqrstuvwxyz0123456789abcdefghijklmnopqrstuvwxyz0123
URL:=http://www.oberhumer.com/opensource/lzo/
endef

And it will show an empty title:

OpenWrt menuconfig for liblzo package (65 characters TITLE)OpenWrt menuconfig for liblzo package (65 characters TITLE)

]]> http://cksum.org/blog/11-openwrt-packages-title-field/feed 0