NSLU2-Linux
view · edit · print · history

OpenEmbedded.OECmdCheatSheet History

Hide minor edits - Show changes to markup

July 31, 2005, at 01:32 PM by Malfi -- OE doesn't use bitkeeper or oemake anymore
Added lines 1-3:

Most of this page is deprecated by now, because OpenEmbedded switched from bitkeeper to monotone and from oemake to bitbake.


March 02, 2005, at 04:34 AM by peteru --
Changed line 69 from:
        bk parent nslu2-linux@nslu2-linux.bkbits.net:packages (to use SSH, which requires write access)
to:
        bk parent bk://nslu2-linux@nslu2-linux.bkbits.net/openembedded (to use SSH, which requires write access)
November 01, 2004, at 04:08 PM by CodeWhacker --
Changed line 43 from:
        bk <editor> <file>
to:
        bk editor <file> (uses your $EDITOR)
October 28, 2004, at 08:35 PM by VoodooZ --
Changed line 37 from:
        splitnslu unpack bootstrap-image-nslu2-???
to:
        splitnslu unpack openslug-image-nslu2-???
Changed line 106 from:
        splitnslu unpack <oe produced bootstrap image from /deploy/images/>
to:
        splitnslu unpack <oe produced image from build/tmp/deploy/images/>
Added lines 124-126:
                - openslug-image.oe
                - unslung-*.oe
October 28, 2004, at 08:32 PM by VoodooZ --
Added lines 19-21:

To undo the most recent pull:

        bk unpull
Changed lines 29-30 from:

To build a complete NSLU flash image:

        oemake bootstrap-image
to:

To build a complete openslug flash image:

        oemake openslug-image (assuming you are building openslug)
Added lines 67-74:

To push up all new changesets to parent:

        bk parent nslu2-linux@nslu2-linux.bkbits.net:packages (to use SSH, which requires write access)
        bk push

To receive and apply a changeset received by mail:

        bk receive < <changeset email file>
        bk resolve
October 14, 2004, at 09:45 PM by rwhitby --
Added lines 4-5:

Note that this page uses building OpenSlug.HomePage OpenSlug? as the worked example, whereas the GettingStarted guide uses building Unslung.HomePage Unslung? the worked example. Hence the two pages differ for a good reason.

October 13, 2004, at 01:43 PM by VoodooZ --
Changed line 112 from:
        $OEROOT/packages/conf:
to:
        $OEROOT/packages/conf/distro/:
Added lines 114-115:
        $OEROOT/packages/conf/machine/:
October 09, 2004, at 04:56 AM by ka6sox --
Changed lines 27-28 from:
        (!!!!! Note that all subsequent oemake commands have to be run from within the build/ directory !!!!!.)
to:
        (!!!!! Note that all subsequent oemake commands have to
be run from within the build/ directory !!!!!.)
Changed lines 76-77 from:
        bk sfiles -c shows local modifications (as does bk -r diffs -u, since it shows
                diffs of all files against the repo but is horribly slow)
to:
        bk sfiles -c   shows local modifications (as does bk -r diffs -u, since
it shows diffs of all files against the repo but is horribly slow)
Changed lines 79-81 from:
                in, but not yet included in a changeset
        bk sfiles -x shows files that are in the repository but not yet
                controlled by bk (handy to make sure you didnt forget to bk add all the patches from a build)
to:
                              in, but not yet included in a changeset
        bk sfiles -x   shows files that are in the repository but not yet
                             controlled by bk (handy to make sure you didnt forget to
bk add all the patches from a build)
October 09, 2004, at 04:52 AM by ka6sox --
Changed line 1 from:

These are notes I took as I slowly climbed the OE/BK learning curve.

to:

These are notes I took as I slowly climbed the OE/BK learning curve.\\

Changed line 26 from:
        (Resulting image is in $OEBUILD/tmp/deploy/images/)
to:
        (Resulting image is in $OEBUILD/tmp/deploy/images/)\\
Changed lines 29-30 from:

To extract the kernel and ramdisk files from the final bootstrap-image file (from within the $OEBUILD/tmp/deploy/images/):

to:

To extract the kernel and ramdisk files from the final bootstrap-image file
(from within the $OEBUILD/tmp/deploy/images/):

Changed lines 134-135 from:
                - various patches
to:
                - various patches
October 06, 2004, at 05:14 PM by VoodooZ --
Changed lines 88-89 from:

Flashing final image to NSLU2 using Redboot (requires serial access):

to:

Flashing final image to NSLU2 using Redboot (requires serial/telnet access):

        from host shell:
Added lines 91-92:
        from RedBoot prompt:
October 06, 2004, at 04:48 PM by VoodooZ --
Changed lines 1-131 from:

Describe OECmdCheatSheet here.

to:

These are notes I took as I slowly climbed the OE/BK learning curve. Feel free to clarify/correct anything as this is just a starting point.


The initial repo clone (from your OE root):

        bk clone bk://nslu2-linux.bkbits.net/packages
        bk clone bk://nslu2-linux.bkbits.net/oe
        bk clone bk://nslu2-linux.bkbits.net/nslu2-package-symlinks

To print or change BK parent

        bk parent

To pull in all the latest changes(from within oe/packages folder:

        bk pull; bk -r co -q

To make a package(s):

        oemake <package(s)>

To clean a package(s):

        oemake -c clean <package(s)>
        ex: oemake -c clean uclibc

To build a complete NSLU flash image:

        oemake bootstrap-image
        (Resulting image is in $OEBUILD/tmp/deploy/images/)
        (!!!!! Note that all subsequent oemake commands have to be run from within the build/ directory !!!!!.)

To extract the kernel and ramdisk files from the final bootstrap-image file (from within the $OEBUILD/tmp/deploy/images/):

        splitnslu unpack bootstrap-image-nslu2-???

To make a file editable (IMPORTANT!):

        bk edit <file>
        <editor> <file>
        or
        bk <editor> <file>

To undo a changeset:

        bk undo

To undo a local change to a file:

        bk unedit
        or
        use the 'discard' option of bk citool

To unlock a file:

        bk unlock

To create/commit a changeset (GUI):

        bk citool

To create a changeset: (command-line)

        bk ci <each modified file>
        bk add <each new file>
        bk commit -y"comments"

To send a changeset to mailing list for peer review:

        bk changes (to obtain changeset#)
        bk send -r <changeset#> nslu-changesets@lists.sf.net

To review changesets:

        bk csets

Revision Tool:

        bk revtool (then open the file in question)

Creating a patch:

        diff -urNd oldtree/ newtree/ > patch

Add a patch to a package:

        add a "file://blahblah.patch;patch=1" entry to the package's SRC_URI.

Listing locally modified files:

        bk sfiles -c shows local modifications (as does bk -r diffs -u, since it shows
                diffs of all files against the repo but is horribly slow)
        bk sfiles -pC (and bk pending) shows changes that have been checked
                in, but not yet included in a changeset
        bk sfiles -x shows files that are in the repository but not yet
                controlled by bk (handy to make sure you didnt forget to bk add all the patches from a build)
        bk sfiles -c | bk diffs -u -

Showing the content of the PN variables of a package .oe file:

        oebuild showdata <path_to_package_oe_file> | grep PN.*=

Forcing a package to retrieve a specific snapshot:

        Add "CVSDATE_<package_name> = <YYYYMMDD>" to the appropriate configuration file (ex: conf/local.conf)

Flashing final image to NSLU2 using Redboot (requires serial access):

        splitnslu unpack <oe produced bootstrap image from /deploy/images/>
        ip_address -l 192.168.2.77 -h 192.168.2.1
        load -r -v -b 0x1000000 <tftp_path>/ramdisk.gz
        load -r -v -b 0x1d00000 <tftp_path>/vmlinuz
        exec 0x1d00000

======================================

Important files:

        $OEBUILD/conf:
                -local.conf

        $OEROOT/packages/meta/:
                - bootstrap-image.oe
                - task-bootstrap.oe

        $OEROOT/packages/conf:
                - openslug.conf
                - nslu2.conf

        $OEROOT/packages/ipkg:


        $OEROOT/packages/files:
                - device_table*

        $OEROOT/packages/classes:
                - nslu2_flashimg.oeclass
                - kernel.oeclass

        $OEROOT/packages/base-files:
                - nslu2/fstab
                - etc/host.conf
                - etc/nsswitch.conf

        $OEROOT/packages/linux/:
                - nslu2-openslug_2.6.7.oe

        $OEROOT/packages/linux/nslu2-openslug-2.6.7:
                - defconfig (contains the linux kernel config settings!!!!)
                - various patches
view · edit · print · history · Last edited by Malfi.
Based on work by peteru, CodeWhacker, VoodooZ, rwhitby, and ka6sox.
Originally by VoodooZ.
Page last modified on July 31, 2005, at 01:32 PM