Annotation of embedaddon/mpd/doc/mpd67.html, revision 1.1
1.1 ! misho 1: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
! 2: <HTML>
! 3: <HEAD>
! 4: <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
! 5: <TITLE>Hints for developers</TITLE>
! 6: </HEAD>
! 7: <BODY text="#000000" bgcolor="#ffffff">
! 8:
! 9: <A HREF="mpd.html"><EM>Mpd 5.6 User Manual</EM></A>
! 10: <b>:</b> <A HREF="mpd64.html"><EM>Internals</EM></A>
! 11: <b>:</b> <EM>Hints for developers</EM><BR>
! 12: <b>Previous:</b> <A HREF="mpd66.html"><EM>Authentication</EM></A><BR>
! 13: <b>Next:</b> <A HREF="mpd68.html"><EM>References</EM></A>
! 14:
! 15:
! 16: <HR NOSHADE>
! 17: <H2><A NAME="67"></A>8.3. Hints for developers<A NAME="developer"></A></H2>
! 18: <p>This chapter describes describes some hints for developers.</p>
! 19: <p>
! 20: <dl>
! 21:
! 22: <dt><b>Source-Code-Style</b><dd><p>There is not so much to say about that, just take a look at the existing
! 23: source files. <br>
! 24: The Tab-Width is eight with an indent of fore. Please make a space between
! 25: operators and operands.</p>
! 26:
! 27: <dt><b>NgFuncGetStats</b><dd><p>NEVER call NgFuncGetStats() with the <em>clear</em> parameter set to true, because
! 28: there are other functions (echo requests/replies, bandwidth management)
! 29: wich relies on increasing link-stats. Mpd carries a copy of the netgraph
! 30: link-stats at link-level, just use these instead. You can call
! 31: LinkUpdateStats() for updating the internal stats-struct.</p>
! 32:
! 33: <dt><b>New Authentication-Backends</b><dd><p>Authentication backends must run independently from the rest of Mpd, i.e.
! 34: you must not access any Mpd resource, because
! 35: the authentication process is started in its own thread (you have to
! 36: take care about thread-safety). An <code>AuthData</code> object is passed
! 37: to your authenticating function which carries a copy of all required
! 38: information. If your backend provides other parameters, like MTU, IP, etc.
! 39: then put these at the appropriate place into <code>AuthData</code> or
! 40: <code>Auth</code>.</p>
! 41: <p>If you can't avoid reading from Mpd's internal data, then acquire the
! 42: Giant Mutex:
! 43: <hr>
! 44: <pre>
! 45: [...]
! 46: pthread_mutex_lock(&gGiantMutex);
! 47: [do whatever]
! 48: pthread_mutex_unlock(&gGiantMutex);
! 49: [...]
! 50: </pre>
! 51: <hr>
! 52: </p>
! 53:
! 54: </dl>
! 55: </p>
! 56:
! 57:
! 58: <HR NOSHADE>
! 59: <A HREF="mpd.html"><EM>Mpd 5.6 User Manual</EM></A>
! 60: <b>:</b> <A HREF="mpd64.html"><EM>Internals</EM></A>
! 61: <b>:</b> <EM>Hints for developers</EM><BR>
! 62: <b>Previous:</b> <A HREF="mpd66.html"><EM>Authentication</EM></A><BR>
! 63: <b>Next:</b> <A HREF="mpd68.html"><EM>References</EM></A>
! 64:
! 65:
! 66:
! 67: </BODY>
! 68: </HTML>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to mpd67.html CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / mpd / doc