• Use a virtual machine: VirtualBox and bhyve are good options.
• Kernel should always have debugging options enabled. CURRENT has most kernel debugging options enabled by default.
• Code should follow FreeBSD Code Style Guidelines, unless there are compelling cases to make exceptions.

Mail technical contact and inline the patch (don't attach, have it as a part of the mail). It may be your e-mail client or something along the way will mess with the patch, so consider providing an url as a backup. The patch should be against head and in unified format (diff -u, git diff, svn diff etc.).

Technical Contact: JohnMarkGurney

Easy

Add missing man pages for parts of the FreeBSD kernel.

MissingManpages directs readers to start at FreeBSD bug 108980 – list of missing man pages.

Currently known missing:

• PCPU stuff: DPCPU_* dpcpu_* PCPU_*
• sched_*
• if_*, like if_setdrvflagbits and many other in if_var.h
• cold (the variable that denotes pre/post interrupts) and maybe other items in sys/systm.h
• cn* (sys/cons.h), such as cnputs
• ppsratecheck
• sys/param.h/cdefs.h helper functions like: powerof2, nitems, setbit, member2struct, <underbar><underbar>offsetof,
• drivers: cesa, glxsb, sec, cryptocteon, nlmsec, rmisec
• device pager: cdev_pager_allocate, mmap_single, vm_pager_allocate
• FEATURE (macro that adds kern.features)
• tty_makedev and friends
• m_ether_tcpip_hash*
• sbuf_uionew
• cdevsw structure
• calculate_crc32c, crc32
• DIOCG* ioctls from sys/disk.h
• Document which standard libc functions are available in the kernel

• minimal C language programming skills.
• Ability to read/write mdoc(7), though jmg@ is willing to help w/ mark up.

Technical Contact: JohnMarkGurney

Easy

Implement additional tests. Currently known missing:

• implement missing sbuf tests, sbuf_core_test.c has a few tests that are if 0'd out at the end of the file

You can look at the atf-c(3) manpage for info on writing tests.

• basic C language programming skills.

Technical Contact: EdMaste

Medium

We've migrated to using the ELF toolchain version of tools like size, strip, nm, etc. Some of the ELF toolchain tools are derivatives of tools that first appeared in the FreeBSD tree, and others are new. There are a few remaining tasks in the ELF toolchain project.

• Identify differences between the ELF toolchain and FreeBSD versions of ar/ranlib and elfdump. Either incorporate ELF toolchain changes into FreeBSD, or incorporate the FreeBSD changes into ELF toolchain, and switch to using the ELF toolchain source from contrib/
• Identify missing functionality relative to contemporary GNU Binutils and implement equivalent functionality in ELF toolchain.

• Knowledge of C
• Knowledge of the ELF format

Technical Contact: JohnMarkGurney

Easy

MissingManpages directs readers to start at FreeBSD bug 108980 – list of missing man pages.

Add or improve man pages:

• intro(3) is missing MANY libraries that are now common
• libc(3) is missing, include reference and places for notable additions, and standards compliance
• timespec, sbintime_t and various sys/time.h are not documented.

• minimal C language programming skills.
• Ability to read/write mdoc(7), though jmg@ is willing to help w/ mark up.

Technical Contact: MateuszGuzik Valid patch received.

Easy

The pattern can be set with the kern.corefile sysctl. No validation is performed.

However, errors are detected during traversal.

Modify the code so that it validates the pattern prior to accepting it.

Technical Contact: MateuszGuzik Valid patch received.

Easy

Self-explanatory.

Rename it to mountlist_lock.

Note that mountlist is rarely modified and even shared locking with rwlocks introduces overhead. Interested person can upgrade this task to non-junior by coming up with a solution exploiting rare need to modify the list. Example approaches include designing a locking primitive with cheap shared locking (think: per-cpu) at the expense of exclusive locking.

• C language programming skills.

Technical Contact: MateuszGuzik

Committed as r280312.

Easy

The kernel keeps core file pattern in corefilename array. It can be modified at any time, including when it is being accessed to generate core names.

Fix the problem.

Technical Contact: MateuszGuzik

Committed as r274167.

Medium

Right now current working directory of a differnent process can be obtained with kern.proc.filedesc sysctl. But it also returns the list of open file descriptors which adds a lot of overhead if the list is long (e.g. 10k entries). One frequent user of this sysctl is tmux which wants current working directory of various processes, but has to obtain the whole list.

Add a sysctl which returns only current working directory or all special entries (see procstat -f output for the list), but no files.

Provide an example patch for tmux utilizing this new functionality.

• C language programming skills.

Technical Contact: MateuszGuzik

Committed as r274122.

Easy

Each instance of strut ucred has a pointer to a table with groups. Current size of struct ucred is 160 bytes, while it occupies space in 256-byte slab (i.e. we waste almost 100 bytes). On the other hand default group limit is 16 which gives 64 byte allocated from 64-byte slab.

Extend struct ucred with gid_t table of XU_NGROUPS elements and use it unless a bigger size is requested, in which case allocate memory just like current code does.

Technical Contact: MateuszGuzik

Committed as r273684.

Easy

Currently setgroups always allocates a temporary buffer. But most callers will provide small number of groups and for such cases a buffer on the stack will work just fine. Provide a temporary buffer capable of holding XU_NGROUPS groups and update the code to use it when appropriate. See sys_poll implementation in kern/sys_generic.c for an example of this approach.

A harder solution would be to pass it down to kern_getgroups which allocates memory anyway and copyin directly to new cred buffer.

• C language programming skills.

Technical Contact: MateuszGuzik

Committed as r273763.

Medium

kern/kern_loginclass.c uses a mutex, even though rwlocks seem to be more suitable. While here update loginclass_find to lookup first and only allocated when needed, but beware of typical races. See uifind in kern/kern_resource.c for an idea how it should look like.

• C language programming skills.