OS/2, eCS & ArcaOS - Technical > Programming

EDM/2 - The API Project - Undocumented

<< < (5/7) > >>

Martin Iturbide:
Hello

I also forgot to clarify my intention or what I want to accomplish.

On the EDM/2 wiki you can link thing to other wiki pages. So when I want to link some specifics "Device Helpers", I get the issue should I standardize the names to "DevHlp_" or "DevHelp_".

I haven't decided yet.

Regards

Martin Iturbide:
Hello

On this page: https://www.os2.kr/komh/os2books/smpadd-19970312/046_L2_HighMemorySupportFun.html

There is listed "DosQueryState", and I can not find any reference to that function. I don't think it exists.

Do you think it may be a typo ? Maybe it is "DosQueryMemState"  because it is after "DosQueryMem"???

Regards

Steven Levine:
I agree that it appears to be a typo.  I was thinking it might have been DosQuerySysState, but since the list is somewhat ordered DosQueryMemState is probably more likely.

Martin Iturbide:
Hello again.

It still spins on my head if I should do something with the DevHelp_ stuff on the EDM/2.
1) Maybe it is more comfortable to standardize it as DevHelp_ since most of the items listed are that way.
or
2) Just leave it that way, and redirect the different names between DevHelp_ and DevHlp_

And:
3) My other issue is that republishing the SMP Addendum there is the STRACE page when it lists the DevHelp and are some that I do not have. You can check it out here with red color on this page.

Regards

Steven Levine:
It really depends on what your goals are.  In general, you will find that the DevHelp prefix is used for C language bindings and DevHlp is used for Assembler bindings.

You can see this pattern if you look at your:

  https://www.edm2.com/index.php/DevHelp_ProcBlock

which looks to me as if it came from pdd.ref.

Notice also that the Assembler bindings are listed before the C bindings implying that they are more likely of more interest.  This is part of history. The kernel and device drivers were originally written in assembler.  It was only later that C became more widely used for device driver development and kernel development.  It would not surprise me if an early version of pdd.ref only documented the Assembler bindings.

This evolution shows up in early books such as Ed Iacobucci's "OS/2 Programmer's Guide" which discusses writing applications in C and Pascal, but all the examples are in Assembler.

The items in red are another case of inconsistent naming.  DevHlp_SortReqPacket is really DevHlp_SortRequest or DevHelp_SortRequest which is in the wiki.  FWIW, DevHlp_SortReqPacket is a better name for the request, but it appears IBM never got around to updating all the references DevHelp_SortRequest, assuming that was the plan.

Navigation

[0] Message Index

[#] Next page

[*] Previous page

Go to full version