OS/2, eCS & ArcaOS - Technical > Programming
EDM/2 - The API Project - Undocumented
Martin Iturbide:
Thanks for the feedback
My goal right now it to link the DevHelp services related pages on the EDM/2 wiki, so the user can jump from an article to the DevHelp service.
I'm thinking that I will standarize the article/page names (just the name) to DevHlp_ since it is most used way in IBM documentation, but I will do it little by little.
Thanks for the help with the names that had changed, here it what I had found for the moment, corrections are welcome.
SMPProgAdd - STRACE || PDDREF:Device Helper (DevHlp)
DevHlp_PushReqPacket - DevHlp_PushRequest
DevHlp_PullReqPacket - DevHlp_PullRequest
DevHlp_SortReqPacket - DevHelp_SortRequest
DevHlp_MonCreate - DevHlp_MonitorCreate
DevHlp_AddTraceEvent - = DevHlp_SysTrace = DevHlp_RAS
DevHlp_ABIOSGetParms - Not found in pddref.inf
DevHlp_Profiling Kernel - Not found in pddref.inf
DevHlp_RegStackUsage - DevHlp_RegisterStackUsage
DevHlp_LogEntry - Not found in pddref.inf
DevHlp_SaveMessage - DevHlp_Save_Message
DevHlp_ReallocSeg - DevHlp_SegRealloc
DevHlp_PutWaitingQueue - Not found in pddref.inf
DevHlp_GetWaitingQueue - Not found in pddref.inf
Compare sources:
- https://www.edm2.com/index.php/PDDREF:Device_Helper_(DevHlp)_Services From pddref.inf
- https://www.edm2.com/index.php/SMPProgAdd_-_STRACE_-_DevHlp_Functions
EDM/2 Lists:
- https://www.edm2.com/index.php/Category:DevHlps
- https://www.edm2.com/index.php/List_of_DevHlp_Functions
Regards
Lars:
--- Quote from: Martin Iturbide on May 22, 2025, 10:09:32 pm ---DevHlp_AddTraceEvent - Not found in pddref.inf
--- End quote ---
DevHlp_AddTraceEvent = DevHlp_SysTrace = DevHlp_RAS
Martin Iturbide:
--- Quote from: Lars on May 27, 2025, 01:47:34 pm ---
--- Quote from: Martin Iturbide on May 22, 2025, 10:09:32 pm ---DevHlp_AddTraceEvent - Not found in pddref.inf
--- End quote ---
DevHlp_AddTraceEvent = DevHlp_SysTrace = DevHlp_RAS
--- End quote ---
Thanks Lars. I think that it makes sense on the wiki to unify the pages for DevHlp_AddTraceEvent , DevHlp_SysTrace, DevHlp_RAS, and clearly specify that the three are the same one.
But which one should be the final name? (There is not an straight right answer, its more like a suggestions) :D
DevHlp_AddTraceEvent was the last name used by IBM on the SMP Addedum (I guess), but I don't know if it is the right choice.
Regards
Steven Levine:
My choice would be DevHlp_RAS for assembler usage and for DevHelp_RAS for C usage because these are what you will find in pdd.ref and the DDK sources.
FWIW, the references you found to DevHlp_AddTraceEvent and DevHlp_SysTrace in the SMP Addendum are not Device Help definitions.
DevHlp_AddTraceEvent is the description the writer chose for Hook ID 61/34 which represents a location in the kernel code. I've yet to find any actual Device Helper related code that actually uses this symbol.
DevHlp_SysTrace is part of a comment in the assembly language example for dh_PerfSysTrace. Again, I've yet to find any actual Device Helper related code that actually uses this symbol.
It probably cannot hunt to mention these alternative references to DevHlp_RAS and DevHelp_RAS, although I'm not sure how I would describe why they exist.
Martin Iturbide:
Hello Steven.
You know more than me on this area.
My references are:
1) DevHlp_AddTraceEvent
-- "SMP Programming Addendum" on the "STRACE - DevHlp Functions"
-- sg244640: "Trace Events for DEVHELP Major Code: 0X0006, Sorted by Tracepoint"
--- OS) DevHlp_AddTraceEvent Post-Invocation 00132 (0X0084)
--- OS) DevHlp_AddTraceEvent Pre-Invocation 00004 (0X0004)
2) DevHlp_SysTrace
-- "Programming Guide and Reference Addendum" on the "Device Helper (DevHlp) Services and Function Codes" at "DevHlp_SysTrace".
There it says "DevHlp_SysTrace is synonymous with DevHlp_RAS."
On "devhlp.inc" from the DDK it has:
--- Quote ---DevHlp_RAS EQU 40 ; 28 Put info in RAS trace buffer
DevHlp_SysTrace EQU 40 ; 28 Synonym for DevHlp_RAS f180062
--- End quote ---
This is why I guess that DevHlp_RAS and DevHlp_SysTrace are the same. No idea about "DevHlp_AddTraceEvent".
Regards
Navigation
[0] Message Index
[#] Next page
[*] Previous page
Go to full version