--- wikisrc/hackathon.mdwn 2011/07/26 21:12:36 1.1 +++ wikisrc/hackathon.mdwn 2012/02/02 21:29:36 1.12 @@ -1,115 +1,92 @@ -= Hackathon 15 = +# Hackathon 16 -The 15th NetBSD hackathon will be run from August 10th to August 15th. -This time, it's a documentation hackathon ('docathon'), our main -focus is improving the NetBSD documentation and advertising. +The 16th NetBSD hackathon will be run from February 10th to February 12th. +Our goal is fixing all the bugs that needs fixing to get +[[NetBSD-current|http://www.NetBSD.org/docs/current/]] ready for the +creation of the NetBSD 6.0 release branch. Join us on the IRC channel #netbsd-code on freenode (irc.freenode.net). -Just join, have a look around and ask your questions or what work needs to be done. +Just join, have a look around and ask your questions or what work needs to +be done. -There's also a thread on netbsd-users, just drop a mail if you're interested. +## Primary goals -Additionally, this hackathon will be held parallel to the CCC camp (http://camp.ccc.de). -Some NetBSD people will be there and expressed interest in a meeting. -Mail to the list if you're interested in the meeting, or contact -via Jabber (prng@jabber.in-berlin.de) or in IRCNet/Freenode (nick: gnrp). - - -== Primary goals == - -We see four main goals one could achieve within five days with enough manpower: - -1. Update and complete the several guides we have. -The NetBSD guide could have some updates (e.g. one could write about npf, -or write one guide for it on its own). -The internals guide has many XXXs in it, too, and the part about regression -testing is factually empty, and perhaps could need one guide on its own. - -2. The wiki needs some work on it. -The old wiki needs to be migrated completely into the new one. - -3. NetBSD could need some new advertising material. Anyone good in writing -texts can make new texts for the current flyers, and if you're good with -inkscape and scribus, creating one or two posters for exhibitions would be -nice, too. - -4. Minor improvements (working on manpages), thinking about versioning the -documentation, address some topics that was not written about before. - - -== Possible topics == - -There were several suggestions on what could be done, so here are topics -somebody wanted to be addressed: - -=== Working on guides === - * Create a list of notebooks and netbooks running NetBSd, what is missing - with them and what is running. This page could suit well into the wiki - where it is editable by more people. - * genfs, fifofs, layerfs and specfs actually have no manpages and nearly no - documentation. Documenting them would be good for writing new FSs. - * Look into internals guide. Every chapter (except for five) has XXXs in it - or misses fundamental information. - * Regression testing needs to be documented. It has a chapter in the - internals guide, but I want to stress this topic, as it is important for - people new to developing with NetBSD. - * The Xen-howto could be updated (http://www.lumbercartel.ca/library/xen/ - might be a good source). - * Write an introduction for people coming from Linux and migrating to - NetBSD, the main differences to consider, etc. - * Create an npf guide (similarly to the PF user's guide - http://openbsd.org/faq/pf/index.html). This doesn't need to be as lengthy - as the OpenBSD one, but having one would be nice. - This can also be addressed in the guide's chapter concerning firewalls. - * The pkgsrc guide could also need updates. Additionally, it would be good - for people new to pkgsrc if the way make works and how dependencies are - automatically resolved would be documented in the guide. - That would make it much easier for people who want to contribute. - * Write an example on how to migrate NetBSD to a new platform. - * Gather and actualize bluetooth information. The chapter in the guide could - be updated. - * Write an article on how to contribute. At the moment, there is - http://www.netbsd.org/contrib/, but having a guide on how NetBSD - development really works, where the code lies and how e.g. the website - is made (it took me weeks to figure out where the website lies), etc. would - be good. - -=== wiki === - * Migrate articles from the old user wiki (http://wiki-static.aydogan.net/) - to the new one. Some progress was documented in - http://wiki.netbsd.org/users/asau/. - * Design a new wiki frontpage and think about how to order the wiki. The old - user wiki had a pretty nice one. - * Create a site for 'general tips' related to NetBSD that don't really fit - into any other category. - * Think of an easier way for new users (non-developers) to contribute to the - wiki. At the moment, the way with getting an OpenID, writing a mail, - waiting for creation and activation is long and difficult. - One could e.g. think about having a simple NetBSD OpenID-server (SimpleID - is quite nice for that) and a registration form so that you don't have to - dig through OpenID first to get an account. - -=== advertising material === - * Work out posters (potentially A0) for exhibitions. Anybody fond with - inkscape, scribus and design could do great work on that! - * Work over the advertising materials, the exiting can be seen here: - http://www.netbsd.org/gallery/advocacy/. - They have nice designs, but are fairly outdated and don't really outline - what NetBSDs benefits are. - * Design new wallpapers. NetBSD needs nice wallpapers for your desktop. ;) - -=== miscellanous documentation === - * pcap(3) could need cross-links (e.g. pcap_next and pcap_next_ex). - * Work over vfs(9) and vnode(9) (some functions missing), and insert them - into the internals guide. - * Work through the packages in pkgsrc/x11 and xsrc and document - correspondences and version numbers there. This is important for working - on pkgsrc's Xorg. - * Update the pages for possible projects and bounties, and think of some - infrastructure on how to make it easily appendable. Currently, there are - three pages for that issue: http://wiki.netbsd.org/projects/, - http://wiki-static.aydogan.net/Bounties and - http://www.netbsd.org/contrib/projects.html. - I think, merging them all into one with a good table for all would be - possible, also coming up with new and gathering existing ideas and - contributing them. +We want NetBSD 6.0 to be the best NetBSD release ever. There are already +a lot of great features in it: + +* Improved kernel performance and scalibity +* New kernel module framework with automatic module loading +* Logic Volume Manager +* NetBSD Packet Filter +* Xen SMP support +* Flash file-system CHFS +* Automated Regression Testing +* Improved FUSE support +* Updated Linux emulation +* GCC 4.5.3 +* Updated X.org X11 distribution +* SMTP authentication client built into Postfix (now version 2.8.7) +* New and enhanced drivers +* ... and many other features + +To make sure that NetBSD users get the best possible experience of +the new release we would like to fix as many as possible of the +following bugs: + +Critical bugs: + +* [[PR 45677|http://gnats.NetBSD.org/45677]]: The stress_killer test sometimes does +* [[PR 45708|http://gnats.NetBSD.org/45708]]: Unable to read big files from large FFSv2 (12TB), ls out of swap +* [[PR 44788|http://gnats.NetBSD.org/44788]]: mlock(2) panic +* [[PR 45187|http://gnats.NetBSD.org/45187]]: select(2) sometimes doesn't wakeup +* [[PR 45833|http://gnats.NetBSD.org/45833]]: occasional crash of 5.99.59: SPL NOT LOWERED ON TRAP EXIT + +Important bugs: + +* [[PR 38670|http://gnats.NetBSD.org/38670]]: ^Z does not seems to suspend programs that vfork'ed and wait. +* [[PR 38965|http://gnats.NetBSD.org/38965]]: ktrace locking issue +* [[PR 39420|http://gnats.NetBSD.org/39420]]: stopped processes can hold locks +* [[PR 42663|http://gnats.NetBSD.org/42663]]: lwp_exit() might race with lwp_free() +* [[PR 44658|http://gnats.NetBSD.org/44658]]: spurious chroot escape warning +* [[PR 34735|http://gnats.NetBSD.org/34735]]: diagnostic assertion failed genfs_vnops.c 1123 +* [[PR 38760|http://gnats.NetBSD.org/38760]]: umount -f /usr panics the system +* [[PR 39548|http://gnats.NetBSD.org/39548]]: kernel debugging assertion "(vp->v_flag & VONWORKLST)" failed +* [[PR 30525|http://gnats.NetBSD.org/30525]]: remounting ffs read-only (mount -ur) does not sync metadata +* [[PR 39264|http://gnats.NetBSD.org/39264]]: newfs can create a filesystem with > 2^31 inodes, which doesn't work (?) +* [[PR 40562|http://gnats.NetBSD.org/40562]]: busy loop in ffs_sync when unmounting a file system +* [[PR 41013|http://gnats.NetBSD.org/41013]]: netbsd5-rc2 crash (kernel diagnostic assertion "vp->v_usecount == 1" failed) +* [[PR 39371|http://gnats.NetBSD.org/39371]]: wapbl should allow mounting "/" even if journal is hosed +* [[PR 39609|http://gnats.NetBSD.org/39609]]: wapbl "replaying log to disk" message is potentially misleading +* [[PR 32318|http://gnats.NetBSD.org/32318]]: NFS client or server hang +* [[PR 39385|http://gnats.NetBSD.org/39385]]: unmounting ptyfs with busy ptys causes deadlock in vrele +* [[PR 40388|http://gnats.NetBSD.org/40388]]: IPv6 incompatibility with pre-5.99.6 binary +* [[PR 38078|http://gnats.NetBSD.org/38078]]: IPFilter lacks documentation almost completely +* [[PR 38457|http://gnats.NetBSD.org/38457]]: ipf doesn't handle IPv6 fragments +* [[PR 39066|http://gnats.NetBSD.org/39066]]: Tty settings mangled. +* [[PR 4029|http://gnats.NetBSD.org/4029]]: Register usage doesn't comply with SPARC ABI +* [[PR 44705|http://gnats.NetBSD.org/44705]]: libc violates sparc ABI by using %g7 +* [[PR 38540|http://gnats.NetBSD.org/38540]]: recent i386 GENERIC kernel cannot boot with VIA chipset +* [[PR 38643|http://gnats.NetBSD.org/38643]]: (dM) st tape drive loses data +* [[PR 39305|http://gnats.NetBSD.org/39305]]: loops through gre(4) cause a hang or crash +* [[PR 42420|http://gnats.NetBSD.org/42420]]: $ORIGIN undefined on NetBSD +* [[PR 40066|http://gnats.NetBSD.org/40066]]: gcc -O1 generates wrong code in loop optimize +* [[PR 40468|http://gnats.NetBSD.org/40468]]: Optimizer bug suspected -- porting devel/libffi to NetBSD/powerpc +* [[PR 30756|http://gnats.NetBSD.org/30756]]: gdb not usable for live debugging of threaded programs +* [[PR 41936|http://gnats.NetBSD.org/41936]]: gdb does not work for threaded programs on sparc64 +* [[PR 41208|http://gnats.NetBSD.org/41208]]: objcopy -S -O binary aborts w/ BFD internal error +* [[PR 41127|http://gnats.NetBSD.org/41127]]: Update/improve newfs docs regarding raw devices +* [[PR 45762|http://gnats.NetBSD.org/45762]]: ntpd default config violates pool.ntp.org policy +* [[PR 40346|http://gnats.NetBSD.org/40346]]: libexpat should be in base.tgz +* [[PR 9582|http://gnats.NetBSD.org/9582]]: sysinst doesn't allow source or pkgsrc installation +* [[PR 38571|http://gnats.NetBSD.org/38571]]: sysinst runs "postinstall fix" +* [[PR 12769|http://gnats.NetBSD.org/12769]]: clarify the upgrade notes for when the sets are on /usr +* [[PR 43314|http://gnats.NetBSD.org/43314]]: pc relative relocations are "off by 1*size" on vax +* [[PR 44159|http://gnats.NetBSD.org/44159]]: startx (xinit) fails +* [[PR 45153|http://gnats.NetBSD.org/45153]]: there should be a build.sh target for building live images +* [[PR 45155|http://gnats.NetBSD.org/45155]]: there are no usb-stick installer images +* [[PR 45439|http://gnats.NetBSD.org/45439]]: gcc generates out-of-range branch insn for m68k +* [[PR 45573|http://gnats.NetBSD.org/45573]]: internal compiler error when building f2c on sparc64 +* [[PR 45620|http://gnats.NetBSD.org/45620]]: MAKEDEV failures remains unoticed in miniroot build +* [[PR 45628|http://gnats.NetBSD.org/45628]]: acpicpu(4) changes between 5.99.55 and 5.99.56 break amd64 +* [[PR 45816|http://gnats.NetBSD.org/45816]]: Screen corruption in German sysinst install +* [[PR 45854|http://gnats.NetBSD.org/45854]]: vnode clean list corruption?