-
Notifications
You must be signed in to change notification settings - Fork 3
/
listing6.html
executable file
·637 lines (511 loc) · 21.6 KB
/
listing6.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
<!-- BEGIN META TAG INFO -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="home" href="http://developer.apple.com/">
<link rel="find" href="http://developer.apple.com/search/">
<link rel="stylesheet" type="text/css" href="../../documentation/css/adcstyle.css" title="fonts">
<script language="JavaScript" src="../../documentation/js/adc.js" type="text/javascript"></script>
<!-- END META TAG INFO -->
<!-- BEGIN TITLE -->
<title>OTMP - /MoreMultiprocessing/MoreMPLog.c</title>
<!-- END TITLE -->
<script language="JavaScript">
function JumpToNewPage() {
window.location=document.scpopupmenu.gotop.value;
return true;
}
</script>
</head>
<!-- BEGIN BODY OPEN -->
<body>
<!--END BODY OPEN -->
<!-- START CENTER OPEN -->
<center>
<!-- END CENTER OPEN -->
<!-- BEGIN LOGO AND SEARCH -->
<!--#include virtual="/includes/adcnavbar"-->
<!-- END LOGO AND SEARCH -->
<!-- START BREADCRUMB -->
<div id="breadcrumb">
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td scope="row"><img width="340" height="10" src="images/1dot.gif" alt=""></td>
<td><img width="340" height="10" src="images/1dot.gif" alt=""></td>
</tr>
<tr valign="middle">
<td align="left" colspan="2">
<a href="http://developer.apple.com/">ADC Home</a> > <a href="../../referencelibrary/index.html">Reference Library</a> > <a href="../../samplecode/index.html">Sample Code</a> > <a href="../../samplecode/Carbon/index.html">Carbon</a> > <a href="../../samplecode/Carbon/idxNetworking-date.html">Networking</a> > <A HREF="javascript:location.replace('index.html');">OTMP</A> >
</td>
</tr>
<tr>
<td colspan="2" scope="row"><img width="680" height="35" src="images/1dot.gif" alt=""></td>
</tr>
</table>
</div>
<!-- END BREADCRUMB -->
<div style="width:100%; position:fixed;"><div align="center" id="watermark" style="position: relative; margin-left:auto; margin-right:auto; z-index:20; width:500px;"><div class="legacybox"><h1>Not Recommended Document<span class=closebutton><a href="javascript:closeWatermark()"><img src="../../images/closebutton.png" width="14" height="14" border="0" alt="close button"></a></span></h1>
<p><strong>Important: </strong>The information in this document is <strong>Not Recommended</strong> and should not be used for new development.</p>
<div class="reflibtopic">
<p>Current information on this Reference Library topic can be found here:</p>
<ul>
<li><a href="http://developer.apple.com/referencelibrary/Carbon/idxNetworking-date.html" target="_blank">Carbon > Networking</a></li>
</ul>
</div>
</div></div></div>
<!-- START MAIN CONTENT -->
<!-- START TITLE GRAPHIC AND INTRO-->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td><h1><div id="pagehead">OTMP</div></h1></td>
</tr>
</table>
<!-- END TITLE GRAPHIC AND INTRO -->
<!-- START WIDE COLUMN -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td id="scdetails">
<h2>/MoreMultiprocessing/MoreMPLog.c</h2>
<form name="scpopupmenu" onSubmit="return false;" method=post>
<p><strong>View Source Code:</strong>
<select name="gotop" onChange="JumpToNewPage();" style="width:340px"><option selected value="ingnore">Select File</option>
<option value="listing1.html">/MIB_Carbon.h</option>
<option value="listing2.html">/MoreMemory/MoreMemory.c</option>
<option value="listing3.html">/MoreMemory/MoreMemory.h</option>
<option value="listing4.html">/MoreMultiprocessing/MoreBlueActions.c</option>
<option value="listing5.html">/MoreMultiprocessing/MoreBlueActions.h</option>
<option value="listing6.html">/MoreMultiprocessing/MoreMPLog.c</option>
<option value="listing7.html">/MoreMultiprocessing/MoreMPLog.h</option>
<option value="listing8.html">/MoreOpenTransport/OTClassicContext.h</option>
<option value="listing9.html">/MoreOpenTransport/OTMP.c</option>
<option value="listing10.html">/MoreOpenTransport/OTMP.h</option>
<option value="listing11.html">/MoreOpenTransport/OTMPSimpleServerHTTP/OTMPSimpleServerHTTP.c</option>
<option value="listing12.html">/MoreOpenTransport/OTMPSimpleServerHTTP/OTMPSimpleServerHTTP.h</option>
<option value="listing13.html">/MoreOpenTransport/OTMPSimpleServerHTTP/OTMPSimpleServerHTTPTest.c</option>
<option value="listing14.html">/MoreOpenTransport/OTMPSimpleServerHTTP/OTMPSimpleServerHTTPTest.r</option>
<option value="listing15.html">/MoreOpenTransport/OTMPSimpleServerHTTP/Sample HTTP Source/index.html</option>
<option value="listing16.html">/MoreOpenTransport/Read_Me_About_OTMP.html</option>
<option value="listing17.html">/MoreProcesses/MoreProcesses.cp</option>
<option value="listing18.html">/MoreProcesses/MoreProcesses.h</option>
<option value="listing19.html">/MoreSetup.h</option></select>
</p>
</form>
<p><strong><a href="OTMP.zip">Download Sample</a></strong> (“OTMP.zip”, 808.3K)<BR>
<strong><a href="OTMP.dmg">Download Sample</a></strong> (“OTMP.dmg”, 1.20M)</p>
<!--
<p><strong><a href="#">Download Sample</a></strong> (“filename.sit”, 500K)</p>
-->
</td>
</tr>
<tr>
<td scope="row"><img width="680" height="10" src="images/1dot.gif" alt=""><br>
<img height="1" width="680" src="images/1dot_919699.gif" alt=""><br>
<img width="680" height="20" src="images/1dot.gif" alt=""></td>
</tr>
<tr>
<td scope="row">
<!--googleon: index -->
<pre class="sourcecodebox">/* File: MoreMPLog.c Contains: MP-safe logging. Written by: Quinn Copyright: Copyright © 2000 by Apple Computer, Inc., All Rights Reserved. Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Computer, Inc. ("Apple") in consideration of your agreement to the following terms, and your use, installation, modification or redistribution of this Apple software constitutes acceptance of these terms. If you do not agree with these terms, please do not use, install, modify or redistribute this Apple software. In consideration of your agreement to abide by the following terms, and subject to these terms, Apple grants you a personal, non-exclusive license, under Apple's copyrights in this original Apple software (the "Apple Software"), to use, reproduce, modify and redistribute the Apple Software, with or without modifications, in source and/or binary forms; provided that if you redistribute the Apple Software in its entirety and without modifications, you must retain this notice and the following text and disclaimers in all such redistributions of the Apple Software. Neither the name, trademarks, service marks or logos of Apple Computer, Inc. may be used to endorse or promote products derived from the Apple Software without specific prior written permission from Apple. Except as expressly stated in this notice, no other rights or licenses, express or implied, are granted by Apple herein, including but not limited to any patent rights that may be infringed by your derivative works or by other works in which the Apple Software may be incorporated. The Apple Software is provided by Apple on an "AS IS" basis. APPLE MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS. IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Change History (most recent first): <4> 21/9/01 Quinn Changes for CWPro7 Mach-O build. <3> 9/7/01 Quinn Removed MPLogPrintfSlow because of problems explained in header file. Removed workaround for Mac OS X Public Beta bugs. <2> 15/2/01 Quinn Changes to work with Project Builder. Because FSp_fopen is a Metrowerks thing we have to define our own version of the routine when building with PB. <1> 7/11/00 Quinn First checked in.*//////////////////////////////////////////////////////////////////////// MoreIsBetter Setup#include "MoreSetup.h"// Mac OS Interfaces#if ! MORE_FRAMEWORK_INCLUDES #include <Multiprocessing.h> #include <DriverSynchronization.h> #include <Gestalt.h>#endif// Standard C interfaces#include <string.h>#include <stdarg.h>#include <stdio.h>// MIB interfaces#include "MoreMemory.h"// Our prototypes#include "MoreMPLog.h"/////////////////////////////////////////////////////////////////////#pragma mark ----- Core Logging Routines -----// CFM export these data structures so that we can find them in MacsBug.// Have to use a macro so that the declspecs don't confuse gcc.#if defined(__MWERKS__) && TARGET_RT_MAC_CFM #define MOREMPLOGVARIABLEEXPORT __declspec (export)#else #define MOREMPLOGVARIABLEEXPORT #endifMOREMPLOGVARIABLEEXPORT ByteCount gMPLogBufferSize = 0;MOREMPLOGVARIABLEEXPORT UInt8 *gMPLogBuffer = nil;MOREMPLOGVARIABLEEXPORT UInt32 gMPLogCurrentBufferIndex = 0;const char *gBufferTerminator = "___End Buffer___";extern pascal OSStatus InitMPLog(ByteCount logBufferSize) // See comment in header file.{ OSStatus err; // The log buffer size must be a power of 2. This is because the // gMPLogCurrentBufferIndex is a free running counter. I simply // mod the counter with the buffer size to get the offset into the // buffer. When gMPLogCurrentBufferIndex wraps around of the 4 GB // mark, things work OK as long as the buffer size is a power of 2. MoreAssertQ((logBufferSize & (logBufferSize - 1)) == 0); // Allocate the buffer. err = noErr; gMPLogBufferSize = logBufferSize; gMPLogCurrentBufferIndex = 0; gMPLogBuffer = (UInt8 *) NewPtrClear(gMPLogBufferSize + strlen(gBufferTerminator)); if (gMPLogBuffer == nil) { err = memFullErr; } if (err == noErr) { // Copy the terminator into the end of the log buffer. BlockMoveData(gBufferTerminator, &gMPLogBuffer[gMPLogBufferSize], strlen(gBufferTerminator)); // If we're not building Carbon, hold the memory so that we can // log at non-deferred interrupt time. Carbon builds don't have // access to HoldMemory; this isn't an issue on Mac OS X but could // cause problems with CarbonLib on Mac OS 9. #if ! TARGET_API_MAC_CARBON err = SafeHoldMemory(gMPLogBuffer, gMPLogBufferSize); if (err != noErr) { DisposePtr( (Ptr) gMPLogBuffer); MoreAssertQ(MemError() == noErr); gMPLogBuffer = nil; } #endif } // If we're building a debug version, the following code will define a // MacsBug macro called "MPLog" which will find the last log entry // marker in the buffer (the '*' character) and then display the last // 256 bytes of the log. This doesn't always work perfectly (for example, // if the log has just wrapped), but it was easy to implement and it works // most of the time. // Don't do this when building Mach-O because there's no MacsBug to // listen to the macro definition. #if MORE_DEBUG && !TARGET_RT_MAC_MACHO if (err == noErr) { char str[256]; sprintf(&str[1], "; mc MPLog \"f %08X %08X '*' ; dm .-100 110\" ; g", gMPLogBuffer, gMPLogBufferSize); str[0] = strlen(&str[1]); DebugStr( (StringPtr) str); } #endif return err;}extern pascal void TermMPLog(void) // See comment in header file.{ UInt8 *tmp; if (gMPLogBuffer != nil) { tmp = gMPLogBuffer; gMPLogBuffer = nil; #if ! TARGET_API_MAC_CARBON { OSStatus junk; junk = SafeUnholdMemory(gMPLogBuffer, gMPLogBufferSize); MoreAssertQ(junk == noErr); } #endif DisposePtr( (Ptr) tmp); MoreAssertQ(MemError() == noErr); }}extern pascal void MPLogText(const UInt8 *text, ByteCount len) // See comment in header file.{ UInt32 lastCharIndex; MoreAssertQ(gMPLogBuffer != nil); // You forgot to call InitMPLog. // Allocate the next N bytes in the log buffer by atomically // adding to the index. lastCharIndex = AddAtomic(len + 2, (SInt32 *) &gMPLogCurrentBufferIndex) + len + 2; // Fill in the log buffer that we allocated with the text. // Plotting this bullet is not 100% certain but it's // sufficiently useful in helping you find the last logged text // that I'm prepared to accept the uncertainty. gMPLogBuffer[lastCharIndex % gMPLogBufferSize] = '*'; lastCharIndex -= 1; gMPLogBuffer[lastCharIndex % gMPLogBufferSize] = '\xC8'; while (len != 0) { len -= 1; lastCharIndex -= 1; gMPLogBuffer[lastCharIndex % gMPLogBufferSize] = text[len]; } lastCharIndex -= 1; gMPLogBuffer[lastCharIndex % gMPLogBufferSize] = '\xC7';}#if defined(__MWERKS__) && !TARGET_RT_MAC_MACHO #include <FSp_fopen.h>#elif TARGET_RT_MAC_MACHO // Mach-O compiler -- You must be building for Carbon on Mac OS X, // so we'll just use FSRefMakePath to make the path to pass to fopen. #include <sys/param.h> static FILE *FSp_fopen(const FSSpec *fss, const char *attr) { OSStatus err; FSRef fsRef; char *path; FILE *result; result = nil; err = noErr; path = malloc(MAXPATHLEN); if (path == nil) { err = memFullErr; } if (err == noErr) { err = FSpCreate(fss, 'CWIE', 'TEXT', smSystemScript); if (err == dupFNErr) { err = noErr; } } if (err == noErr) { err = FSpMakeFSRef(fss, &fsRef); } if (err == noErr) { err = FSRefMakePath(&fsRef, (UInt8 *) path, MAXPATHLEN); } if (err == noErr) { result = fopen(path, attr); } // Clean up. if (path != nil) { free(path); } return result; }#else #error What compiler are you using?#endifextern pascal OSStatus MPLogWriteToFile(const FSSpec *fss) // See comment in header file.{ OSStatus err; FILE *output; SInt32 rowMax; SInt32 row; SInt32 col; UInt32 index; UInt8 ch; MoreAssertQ(gMPLogBuffer != nil); // You forgot to call InitMPLog. err = noErr; (void) FSpDelete(fss); output = FSp_fopen(fss, "w"); if (output == nil) { err = -1; } // Print the log buffer to the file. Note that the output is an // exact match of the MacsBug "dm" command. This is not a coincidence. if (err == noErr) { rowMax = (gMPLogBufferSize + 15) / 16; index = 0; for (row = 0; row < rowMax; row++) { fprintf(output, " %08lX ", index); for (col = 0; col < 16; col+=2) { if ((index + col) < gMPLogBufferSize) { fprintf(output, "%04X ", *((UInt16 *) &gMPLogBuffer[index + col])); } else { fprintf(output, " "); } } fprintf(output, " "); for (col = 0; col < 16; col++) { if ((index + col) < gMPLogBufferSize) { ch = gMPLogBuffer[index + col]; if (ch < 32) { ch = '.'; } fprintf(output, "%c", ch); } else { fprintf(output, " "); } } fprintf(output, "\n"); index += 16; } (void) fclose(output); } return err;}/////////////////////////////////////////////////////////////////#pragma mark ----- Log Points -----#if MORE_DEBUG static UInt32 gLogMask = 0; extern pascal void MPLogSetMask(UInt32 logMask) { gLogMask = logMask; } extern pascal UInt32 MPLogGetMask(void) { return gLogMask; } // This section of code makes heavy use of sprintf. // I'm a little worried about this because there's no guarantee // that sprintf is MP safe. For the moment I'm going to let it // slide, but it would be good to revisit. extern pascal void MPLog(UInt32 module, OSType tag) { char tmpStr[256]; if ( gLogMask & (1 << module) ) { (void) sprintf(tmpStr, "[%08lx]%4.4s", (UInt32) MPCurrentTaskID(), (char *) &tag); MPLogText( (UInt8 *) tmpStr, strlen(tmpStr)); } } extern pascal void MPLog1(UInt32 module, OSType tag, const void *p1) { char tmpStr[256]; if ( gLogMask & (1 << module) ) { (void) sprintf(tmpStr, "[%08lx]%4.4s %08lx ", (UInt32) MPCurrentTaskID(), (char *) &tag, (UInt32) p1); MPLogText( (UInt8 *) tmpStr, strlen(tmpStr)); } } extern pascal void MPLog2(UInt32 module, OSType tag, const void *p1, const void *p2) { char tmpStr[256]; if ( gLogMask & (1 << module) ) { (void) sprintf(tmpStr, "[%08lx]%4.4s %08lx %08lx ", (UInt32) MPCurrentTaskID(), (char *) &tag, (UInt32) p1, (UInt32) p2); MPLogText( (UInt8 *) tmpStr, strlen(tmpStr)); } } extern pascal void MPLog3(UInt32 module, OSType tag, const void *p1, const void *p2, const void *p3) { char tmpStr[256]; if ( gLogMask & (1 << module) ) { (void) sprintf(tmpStr, "[%08lx]%4.4s %08lx %08lx %08lx ", (UInt32) MPCurrentTaskID(), (char *) &tag, (UInt32) p1, (UInt32) p2, (UInt32) p3); MPLogText( (UInt8 *) tmpStr, strlen(tmpStr)); } } extern pascal void MPLog4(UInt32 module, OSType tag, const void *p1, const void *p2, const void *p3, const void *p4) { char tmpStr[256]; if ( gLogMask & (1 << module) ) { (void) sprintf(tmpStr, "[%08lx]%4.4s %08lx %08lx %08lx %08lx", (UInt32) MPCurrentTaskID(), (char *) &tag, (UInt32) p1, (UInt32) p2, (UInt32) p3, (UInt32) p4); MPLogText( (UInt8 *) tmpStr, strlen(tmpStr)); } }#endif/////////////////////////////////////////////////////////////////////#pragma mark ----- Utility printf Routines -----extern void MPLogPrintf(const char *format, ...) // See comment in header file.{ char tmpStr[256]; va_list args; va_start(args, format); vsprintf(tmpStr, format, args); MPLogText( (UInt8 *) tmpStr, strlen(tmpStr)); va_end(args);}#if 0// See comment in header file.// MPLogPrintfSlow uses MPRemoteCall to get back to system task // time in order to print to the console. It needs multiple // parameters to do this, which it collects into the BluePrinterArgs // parameter block.enum { kBluePrinterArgsMagic = 'BlPr'};struct BluePrinterArgs { OSType magic; // must be kBluePrinterArgsMagic const char * format; va_list args;};typedef struct BluePrinterArgs BluePrinterArgs;static void *BluePrinter(void *parameter){ BluePrinterArgs *blue; blue = (BluePrinterArgs *) parameter; MoreAssertQ(blue->magic == kBluePrinterArgsMagic); vprintf(blue->format, blue->args); fflush(stdout); return nil;}extern void MPLogPrintfSlow(const char *format, ...) // See comment in header file.{ BluePrinterArgs blue; va_list args; va_start(args, format); blue.magic = kBluePrinterArgsMagic; blue.format = format; blue.args = args; (void) MPRemoteCall(BluePrinter, &blue, kMPOwningProcessRemoteContext); va_end(args);}#endif</pre>
<!--googleoff: index -->
</td>
</tr>
</table>
<!-- END WIDE COLUMN -->
<!-- END MAIN CONTENT -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td><div style="width: 100%; height: 1px; background-color: #919699; margin-top: 5px; margin-bottom: 15px"></div></td>
</tr>
<tr>
<td align="center"><br/>
<table border="0" cellpadding="0" cellspacing="0" class="graybox">
<tr>
<th>Did this document help you?</th>
</tr>
<tr>
<td>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=1&url=/samplecode/OTMP/listing6.html%3Fid%3DDTS10000251-1.0&media=dvd" target=_new>Yes</a>: Tell us what works for you.</div>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=2&url=/samplecode/OTMP/listing6.html%3Fid%3DDTS10000251-1.0&media=dvd" target=_new>It’s good, but:</a> Report typos, inaccuracies, and so forth.</div>
<div><a href="http://developer.apple.com/feedback/?v=3&url=/samplecode/OTMP/listing6.html%3Fid%3DDTS10000251-1.0&media=dvd" target=_new>It wasn’t helpful</a>: Tell us what would have helped.</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- START BOTTOM APPLE NAVIGATION -->
<!--#include virtual="/includes/footer"-->
<!-- END BOTTOM APPLE NAVIGATION -->
<!-- START CENTER CLOSE -->
</center>
<!-- END CENTER CLOSE -->
</body>
</html>