OS/2, eCS & ArcaOS - Technical > Programming

EDM/2 - The API Project - Undocumented

<< < (6/7) > >>

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