Slashdot Mirror

← Back to Stories (view on slashdot.org)

Darwin Kernel Programming

Posted by pudge on from the documentation-gooooood dept.

ZigMonty writes "Apple has updated their Kernel Programming docs (May 1st). They are a lot more substantial now (read: they say something other than 'don't')."

15 comments

  1. humor in the manaul by cremes · · Score: 3, Funny
    Under the VFS section, there's a subsection entitled "A Politically Correct Example."
    A Politically Correct Example

    The Politically Correct File System is an example of a VFS stack. In this example, all calls are ignored (passed to the underlying layer) except for those that create, read, or write a file (or folder).

    Upon receiving a request to create a file or folder, the Politically Correct (PC) stack intercepts the call before it can be executed by the underlying file system. The PC version of the create call checks the requested filename against a table of names. If the name is deemed politically incorrect, for example if the user chooses to name a file "vulgarity", the PC create call chooses a more pleasing name, for example, "politeness". The new name is passed to the create routine of the underlying file system.

    Similarly, when a user opens a file to read or write it, such as with a text editor, the PC read and write routines first examine the data buffer, possibly substituting preferred words and phrases for their undesirable counterparts. After the substitutions are made, the buffer is handed to the underlying routine, which displays the data or writes it to disk.

    Thus, if a user attempted to save a file containing a sentence such as this:

    The beleaguered computer company's woes continue, despite rising stock prices.

    the PC write routine might intercept and filter this sentence to a more desirable version:

    The aspiring computer company's joys continue, due to rising stock prices.

    cr
    1. Re:humor in the manaul by Matthias+Wiesmann · · Score: 2, Interesting

      This is typical, many Apple docs were peppered with jokes. The examples for the GUI in the Inside Macintosh were about about SurfWriter, the coolest word processor (or something like that). Most glossaries had an (incomplete) entry for RTFM, etc...

  2. Good documentation is scarce by cremes · · Score: 2, Interesting

    I went through the previous incarnation of this manual and it was pretty lousy. I haven't had a good chance yet to study this one, but if they added any new information to it then I'll be happy.

    The documentation for Apple's new systems has been rather poor. I've been writing an IOKit driver (check it out at http://sourceforge.net/projects/darwin-tulip/) and had a hell of a time figuring out some of the tricks. Some of that was related to this project being my first attempt at a driver (:-), but there were some critical areas where the documentation stopped dead in its tracks and said "This section is not written yet." D'oh!

    My next project after this ethernet driver is to write either a) an opensource tool to defrag HFS+, or b) a VFS driver. If I do (a) first it will help with (b). I'm counting on there being better documentation on VFS than currently exists. I've started looking at the source code (the only documentation that exists on VFS), but it can take many months to become proficient with its internal workings; good doc should cut that down some.

    cr

    1. Re:Good documentation is scarce by Anonymous Coward · · Score: 0



      Its likely that Apple is focusing all its efforts on building OS X so that it matches the speed of other (less stable) OSs. They're tossing the grenades now, and picking up the pieces later.

    2. Re:Good documentation is scarce by cremes · · Score: 1

      That's fine for them, but tough for developers. Developers have to HELP them to make the OS the best it can be. However, that task becomes nearly impossible if you can't figure out how to use the new gee-whiz features to create the Next Big Thing.

      Docs are very important. The old Apple knew it. I hope the new Apple is learning it.

      cr

  3. Many documentation updates... by h0tblack · · Score: 3, Interesting

    ...have appeared in the build up to the start of the WWDC (today).
    There's also an updated "UNIX Porting Guide"
    http://developer.apple.com/techpubs/macosx /Darwin/ index.html

    All of the latest updates can be found here:
    http://developer.apple.com/techpubs/macosx/ whatsne w.html

    One of the older bits of documentation I came across recently was that on Assembly under OS X, including details for the i386 architecture.
    http://developer.apple.com/techpubs /macosx/Develop erTools/Assembler/AssemblerTOC.html

  4. Re:grook [NvwsCoach / CKW #4] by Anonymous Coward · · Score: 0

    You said it was there, so it meant you wanted people to look at it!
    You shouldn't play with words like that, because people may question your maturity, and then you'll start having anxiety attacks again, and you don't want that, do you?

    NaveWeiss Coaching service - helping the community since 2002!

  5. Re:grook [weiss] by Anonymous Coward · · Score: 0

    Yo CKW! Wassup?

    Exactly when did I tell you to look at anything?

    You wrote about it, so you want people to look at it, because it wouldn't make any sense otherwise - and you want to be a logical person, no?

    Time to get your ass pounded by violent rapists, NaveWeiss.

    You surely got weird ways to express your love to me. But don't worry - we can work together on a better fantasy for you, which doesn't involve me or Metrollica.

    Authentic posting by NaveWeiss . Appreciate it.

  6. Re:grook [weiss] by Anonymous Coward · · Score: 0

    So do you click on banner ads every time they pop up? Perhaps your subservient lifestyle has trained you to follow everyone else and not think for yourself.