RFR (S): 6516521: Doc: should document about the primordial thread attaching to the VM

[David Holmes]

Thanks Dan!

David

On 12/10/2018 5:23 AM, Daniel D. Daugherty wrote:
> Thumbs up on the new additional text.
> 
> Dan
> 
> 
> On 10/11/18 5:45 AM, David Holmes wrote:
>> Although the JNI spec itself is not an open document I see no reason 
>> not to get feedback on this simple update.
>>
>> Bug: https://bugs.openjdk.java.net/browse/JDK-6516521
>>
>> ---
>> Chapter 5: The Invocation API
>>
>> Creating the VM
>>
>> The JNI_CreateJavaVM() function loads and initializes a Java VM and 
>> returns a pointer to the JNI interface pointer. The thread that called 
>> JNI_CreateJavaVM() is considered to be the main thread.
>> ---
>>
>> Proposed additional text:
>>
>> *Note:* Depending on the operating system, the primordial process 
>> thread may be subject to special handling that impacts its ability to 
>> function properly as a normal Java thread (such as having a limited 
>> stack size and being able to throw `StackOverflowError`). It is 
>> strongly recommended that the primordial thread is not used to load 
>> the Java VM, but that a new thread is created just for that purpose.
>>
>> Thanks,
>> David
>>
>