✎ soc:2008:mdeck:journal:start - Etherboot/gPXE Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Michael Decker: Driver Development ======

===== Journal =====

The following is a log of steps I've taken.  Note that I don't use Linux on a daily basis.  Any terminal commands below are for my reference.

==== Week 0 ====

=== 19 May 2008 ===

  * Installed libc6-dev, mtools, syslinux, & gitk with Synaptic Program Manager (SPM) 
  * Cloned git tree into samba share <code>$ git clone git://git.etherboot.org/scm/gpxe.git</code>
  * Successfully built gpxe <code>$ make</code>
  * Wrote to usb key, booted successfully on target <code>$ dd if=bin/gpxe.usb of=/dev/sdb</code>
  * Installed dhcp3-server via SPM and configured
    * Added interface to ''/etc/default/dhcp3-server'' <code>INTERFACES="eth0"</code>
    * Modified ''/etc/dhcp3/dhcpd.conf'' <code>

# dhcpd.conf
#

ddns-update-style none;
not authoritative;

default-lease-time 600;
max-lease-time 7200;

host h1 { 
  hardware ethernet 00:11:22:33:44:7b; 
}

host h2 {
  hardware ethernet 00:11:22:33:44:b0;
}

shared-network "net" {
subnet 192.168.2.0 netmask 255.255.255.0 {
  range 192.168.2.10 192.168.2.20;
  option subnet-mask 255.255.255.0;
  option routers 192.168.2.1;
  deny unknown-clients;

  option root-path "192.168.2.1:/tftpboot";
  filename "test";
}
}</code> This configuration was made utilizing [[:twodhcpservers|this page]] and [[http://linux.die.net/man/5/dhcpd.conf|man dhcpd.conf]].  Hosts ''h1'' and ''h2'' are two different ethernet ports on the target.  After making changes: <code>$ /etc/init.d/dhcp3-server restart</code>
  * Installed tftpd-hpa via SPM and configured
    * Created ''/tftpboot'' directory
    * Modified ''/etc/inetd.conf'' <code>tftp dgram udp wait root /usr/sbin/in.tftpd /usr/sbin/in.tftpd -s /tftpboot</code>

=== 20 May 2008 ===

  * Tested ATA-over-Ethernet
    * Changed dhcpd.conf: <code>
# dhcpd.conf
#

ddns-update-style none;
not authoritative;

default-lease-time 600;
max-lease-time 7200;

ignore unknown-clients;

host h1 {
  hardware ethernet 00:11:22:33:44:7b; 
  filename "";
  option root-path "aoe:e0.0";
}

class "c1" {
  match if option vendor-class-identifier = "Etherboot";
}

subnet 192.168.1.0 netmask 255.255.255.0 {
  pool {
	deny members of "c1";
	range 192.168.1.10 192.168.1.20;
  }
}
</code> This is setup such that no IP is allocated, although the aoe boot will initiate for host ''h1''.  In this way, Windows will retrieve an IP from the proper DHCP server when it starts.  The DHCP server being configured exists on the AOE server only to establish AOE sessions.
    * Configured my 'normal' DHCP server to ignore etherboot DHCP requests<code>dhcp-vendorclass=eth,Etherboot
dhcp-ignore=eth</code>
    * Followed additional AOE steps outlined in [[:sanboot:winxp|HowTo]]

==== Week 1 ====

=== 26 May 2008 ===

  * Converted ''#ifdef DEBUG printf(..)'' and ''hd(..)'' statements to ''DBG(..)'' and ''DBG_HD(..)'' in ''eepro100.c''
  * Collected & sorted notes on Etherboot and gPXE driver API

=== 27 May 2008 ===

  * Further gPXE network driver API documentation
  * Hardware problems encountered; consulted with mdc

=== 28 May 2008 ===

  * [[:soc:2008:mdeck:notes:gpxe_driver_api|gPXE Network Driver API]] documentation continues.
  * [[:soc:2008:mdeck:notes:initialization|gPXE Network Driver Initialization]] document added.


=== 29 May 2008 ===

  * [[:soc:2008:mdeck:notes:gpxe_driver_api|gPXE Network Driver API]] documentation updated.
  * Specific changes to eepro100.c begin.

=== 30 May 2008 ===

  * Fixed repository in git
    * Modified .git/config <code>
[remote "personal"]
        url = mdeck@rom.etherboot.org:/pub/scm/people/mdeck/gpxe.git
</code> to <code>
[remote "personal"]
        url = ssh://mdeck@rom.etherboot.org//pub/scm/people/mdeck/gpxe.git
</code> The erroneous configuration was created from [[:soc:2008:git-usage|here]].
    * Setup my personal info <code>
mike@vaio:~/Shared/repo/gpxe$ git config user.name "Michael Decker"
mike@vaio:~/Shared/repo/gpxe$ git config user.email "mrd999@gmail.com"
mike@vaio:~/Shared/repo/gpxe$ cd ..
mike@vaio:~/Shared/repo$ mv gpxe gpxe.git
mike@vaio:~/Shared/repo$ cd gpxe.git/</code>
    * Created personal/drivers branch<code>
$ git-checkout -b drivers origin/master
$ git-push personal drivers
</code>
    * Reinitialized personal/master branch<code>
mike@vaio:~/Shared/repo/gpxe.git$ git-branch
  drivers
* master

mike@vaio:~/Shared/repo/gpxe.git$ git-branch -d -r personal/master
Deleted remote branch personal/master.

mike@vaio:~/Shared/repo/gpxe.git$ git push personal :master
mdeck@rom.etherboot.org's password:
refs/heads/master: 72c77282442fd098a7c762222ba49b55c48d4f82 -> deleted
To ssh://mdeck@rom.etherboot.org//pub/scm/people/mdeck/gpxe.git
 - [deleted]         master
error: unlink(.git/refs/remotes/personal/master) failed: No such file or directory
error: Failed to delete

mike@vaio:~/Shared/repo/gpxe.git$ git-push personal master
mdeck@rom.etherboot.org's password:
Total 0 (delta 0), reused 0 (delta 0)
refs/heads/master: 0000000000000000000000000000000000000000 -> c899bdc5a823e623b3e8f7598a7f77d65dcf2d2c
To ssh://mdeck@rom.etherboot.org//pub/scm/people/mdeck/gpxe.git
 * [new branch]      master -> master

mike@vaio:~/Shared/repo/gpxe.git$ git-checkout drivers
Switched to branch "drivers"
</code>
  * Git commit [[http://git.etherboot.org/?p=people/mdeck/gpxe.git;a=commitdiff;h=0c3deabe7865741c629b422c5abf20369ac04b0a|0c3deabe7865741c629b422c5abf20369ac04b0a]]
  * Setup [[:soc:2008:mdeck:notes:start#build_environment|new target machine]].
  * Tested booting with new target.
    * Fixed dhcpd.conf for new configuration <code>
# dhcpd.conf
#

ddns-update-style none;
not authoritative;
ignore unknown-clients;

default-lease-time 600;
max-lease-time 7200;

option space gpxe;
option gpxe-encap-opts code 175 = encapsulate gpxe;
option gpxe.bus-id code 177 = string;

option subnet-mask 255.255.255.0;
option routers 192.168.1.1;
option domain-name-servers 192.168.1.1;

subnet 192.168.1.0 netmask 255.255.255.0 {
	range 192.168.1.10 192.168.1.20;
}

host h1 {
  hardware ethernet 00:11:d8:0e:93:7b; 
  filename "";
  option root-path "aoe:e0.0";
}

host h2 {
  # motherboard ethernet adapter 
  hardware ethernet 00:1F:C6:20:E2:B5;
  filename "eepro100.pxe";

#  if we're not talking to gPXE load this filename
#  if not exists gpxe.bus-id {
#    filename "eepro100.pxe";
#  }

}

host h3 {
  hardware ethernet 00:90:27:43:84:4B;         # eepro100 card for testing

# For booting via http, Toms Root Boot
#  filename "http://rom.etherboot.org/gtest/gtest.gpxe";

# For booting Windows
  filename "";
  option root-path "aoe:e0.0";
}
</code>
    * Got chainloading from PXE operational. PXE -> gPXE -> (http or aoe)
  * Code review on driver changes with mdc.
  * Attempted to fix vblade.

=== 31 May 2008 ===

  * Fixed vblade
    * Changed mount of file system containing AoE image <code>
$ sudo umount /dev/sda4
$ sudo mount /dev/sda4 /media/test
</code>
    * Modified /etc/vblade.conf <code>
# example configuration file
# network_device shelf slot file/disk/partition mac[,mac[,mac]]
#eth0 0 0 /dev/sdb 00:11:22:33:44:55
eth0 0 0 '/media/Spare Room/test/disk.img'
</code> to <code>
# example configuration file
# network_device shelf slot file/disk/partition mac[,mac[,mac]]
#eth0 0 0 /dev/sdb 00:11:22:33:44:55
eth0 0 0 /media/test/test/disk.img
</code> vblade didn't appear to like the space.
    * ''$ /etc/init.d/vblade start''
  * Successfully booted Windows image over AoE
  * Setup local chainloading environment
    * Installed apache2 on server
    * Copied gtest.gpxe into /var/www
    * Modified /etc/dhcp3/dhcpd.conf <code>
host h3 {
  hardware ethernet 00:90:27:43:84:4B;         # eepro100 card for testing

# For booting via http
  filename "http://192.168.1.9/gtest.gpxe";

# For booting Windows
#  filename "";
#  option root-path "aoe:e0.0";
}
</code> And ''$ sudo /etc/init.d/dhcp3-server restart''
    * Successfully chainloaded gPXE script from local httpd!
  * Git commit [[http://git.etherboot.org/?p=people/mdeck/gpxe.git;a=commitdiff;h=dd467a97c6d0972d3d930329ccd51ad0f7a17fcf|dd467a97c6d0972d3d930329ccd51ad0f7a17fcf]]

=== 1 June ===

  * eepro100.c : Began restructuring code. 
  * Added new gPXE API functions
  * Converted existing function parameters and types. 
  * Shifted some parts, splitting up code as appropriate.

==== Week 2 ====

=== 4 June ===

  * More coding.  
  * Renamed some functions for more consistency.  
  * Migrated global state into net_device private data structure.  
  * Separated some EEPROM code into a separate routine.  
  * Proliferated comments.
  * Encapsulated SCB command routine.

=== 5 June ===

  * More code, of course. 8-)
  * Shifted defines and enums into a new eepro100.h to reduce the clutter.
  * More renaming to enhance organization & match Intel datasheet.
  * Added error checking into eepro100_poll() 
  * Migrated Etherboot packet rx to gXE rx in eepro100_poll()
  * Lost power mid-day; discovered need for more frequent commits & pushes :-/
  * Git commits [[http://git.etherboot.org/?p=people/mdeck/gpxe.git;a=commit;h=b95078936df49852dfe2ef6fc6d2c939b6b53794|b95078936df49852dfe2ef6fc6d2c939b6b53794]]  and [[http://git.etherboot.org/?p=people/mdeck/gpxe.git;a=commit;h=61c6bdbb2a992879771059bc7b20eb7dfdbbaa91|61c6bdbb2a992879771059bc7b20eb7dfdbbaa91]]

=== 6 June ===

I spoke with mdc & mcb30 this morning during our weekly meeting.  My commits contained both code changes and formatting changes, intermingled, which made reviewing the code difficult.    So the previous commits need to be respun to make for easier review.

I found that my existing commits contained too much variation to be cleaned up without making more fine-grained commits.  Thus, I spent the day working on this.  I had some trouble with git, mainly in that I managed to spend a few hours making new commits only to realize I had not replaced the spaces with tabs (argh!).  So I had to start over.  At this point I'm still respinning so I have no commit to post tonight.

This should be a one-time event as SCM and making commits is all new to me.  From now on I plan to make fine-grained commits such that my code is reviewable. (As the ultimate goal of my code is a positive review.)

=== 7 June ===

Spent the day attempting to respin, although it was slow-going as small problems with git added up into redoing things many times.  Spent quite some time trying to find the cause of changes git reported that looked like identical lines.  Discovered pasting code from Firefox inserts weird line feeds which were getting converted when I reopened the file.  Realized git-cherry-pick will create a new commit if it succeeds, but will not create a new commit if it fails.  I think.  :-?  Expect to push soon.

=== 8 June ===

Reached a point where I wouldn't mind pushing, although more respinning is still pending.  However, git spat out a mysterious error:
<code>$ git-push personal drivers4
mdeck@rom.etherboot.org's password:
fatal: invalid number of threads specified (0)
$ git-gc
fatal: invalid number of threads specified (0)
error: failed to run repack</code>
I don't know what caused this to suddenly happen, but now I can not push from any repository or branch.
I spent a few hours working with Marty to fix this, but for now we decided I would use a work-around by uploading the repository to rom.etherboot.org and pushing from there, which works.
  * Commit: [[http://git.etherboot.org/?p=people/mdeck/gpxe.git;a=commit;h=5848ad2b6bed066fe33bcc0a6b07178f7f38094a|[Drivers-eepro100] Updated debug statement functions]]
  * Commit: [[http://git.etherboot.org/?p=people/mdeck/gpxe.git;a=commit;h=0c2ae838f8fba1d7bcbf4434c78eb1ba61a48a55|[Drivers-eepro100] Removed 'int rx_mode' since gPXE uses ALLMULTI.]]
  * Commit: [[http://git.etherboot.org/?p=people/mdeck/gpxe.git;a=commit;h=747dc1c55328c14574536402cd8d60acd27f1fcb|[Drivers-eepro100] Skeleton changes from Etherboot -> gPXE conformance.]]
  * Commit: [[http://git.etherboot.org/?p=people/mdeck/gpxe.git;a=commit;h=de3529d1bc37d98ce3dd488dd7f51478fcd0bf3c|[Drivers-eepro100] Migrated global data from file-scope to instance-scope]]
More commits on the way.
--\\
**Solved!!**\\ Shortly later Marty mentioned something in ''~/.gitconfig'', whereupon I found a setting:<code>[pack]
        threads = 0</code> Which I promptly changed to:<code>[pack]
        threads = 1</code> Which fixed the problem!  I must have accidentally changed that setting and caused such headaches.
Trace: • debian_lenny_iscsi • 2009 • week5 • win2k8_iscsi_direct • memsearch • week5 • win2k8_iscsi_install • journal • week9 • week5 • week12 • fedora • ubuntu_iscsi • week4 • week6 • dnsmasq • week5 • week4 • ideas