{"action":"created","issue":{"url":"https://api.github.com/repos/eclipse/openj9-docs/issues/82","repository_url":"https://api.github.com/repos/eclipse/openj9-docs","labels_url":"https://api.github.com/repos/eclipse/openj9-docs/issues/82/labels{/name}","comments_url":"https://api.github.com/repos/eclipse/openj9-docs/issues/82/comments","events_url":"https://api.github.com/repos/eclipse/openj9-docs/issues/82/events","html_url":"https://github.com/eclipse/openj9-docs/issues/82","id":358711100,"node_id":"MDU6SXNzdWUzNTg3MTExMDA=","number":82,"title":"Adding Mac platform support to the user docs","user":{"login":"SueChaplain","id":18395037,"node_id":"MDQ6VXNlcjE4Mzk1MDM3","avatar_url":"https://avatars0.githubusercontent.com/u/18395037?v=4","gravatar_id":"","url":"https://api.github.com/users/SueChaplain","html_url":"https://github.com/SueChaplain","followers_url":"https://api.github.com/users/SueChaplain/followers","following_url":"https://api.github.com/users/SueChaplain/following{/other_user}","gists_url":"https://api.github.com/users/SueChaplain/gists{/gist_id}","starred_url":"https://api.github.com/users/SueChaplain/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SueChaplain/subscriptions","organizations_url":"https://api.github.com/users/SueChaplain/orgs","repos_url":"https://api.github.com/users/SueChaplain/repos","events_url":"https://api.github.com/users/SueChaplain/events{/privacy}","received_events_url":"https://api.github.com/users/SueChaplain/received_events","type":"User","site_admin":false},"labels":[{"id":772491793,"node_id":"MDU6TGFiZWw3NzI0OTE3OTM=","url":"https://api.github.com/repos/eclipse/openj9-docs/labels/enhancement","name":"enhancement","color":"84b6eb","default":true}],"state":"open","locked":false,"assignee":{"login":"SueChaplain","id":18395037,"node_id":"MDQ6VXNlcjE4Mzk1MDM3","avatar_url":"https://avatars0.githubusercontent.com/u/18395037?v=4","gravatar_id":"","url":"https://api.github.com/users/SueChaplain","html_url":"https://github.com/SueChaplain","followers_url":"https://api.github.com/users/SueChaplain/followers","following_url":"https://api.github.com/users/SueChaplain/following{/other_user}","gists_url":"https://api.github.com/users/SueChaplain/gists{/gist_id}","starred_url":"https://api.github.com/users/SueChaplain/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SueChaplain/subscriptions","organizations_url":"https://api.github.com/users/SueChaplain/orgs","repos_url":"https://api.github.com/users/SueChaplain/repos","events_url":"https://api.github.com/users/SueChaplain/events{/privacy}","received_events_url":"https://api.github.com/users/SueChaplain/received_events","type":"User","site_admin":false},"assignees":[{"login":"SueChaplain","id":18395037,"node_id":"MDQ6VXNlcjE4Mzk1MDM3","avatar_url":"https://avatars0.githubusercontent.com/u/18395037?v=4","gravatar_id":"","url":"https://api.github.com/users/SueChaplain","html_url":"https://github.com/SueChaplain","followers_url":"https://api.github.com/users/SueChaplain/followers","following_url":"https://api.github.com/users/SueChaplain/following{/other_user}","gists_url":"https://api.github.com/users/SueChaplain/gists{/gist_id}","starred_url":"https://api.github.com/users/SueChaplain/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SueChaplain/subscriptions","organizations_url":"https://api.github.com/users/SueChaplain/orgs","repos_url":"https://api.github.com/users/SueChaplain/repos","events_url":"https://api.github.com/users/SueChaplain/events{/privacy}","received_events_url":"https://api.github.com/users/SueChaplain/received_events","type":"User","site_admin":false}],"milestone":null,"comments":21,"created_at":"2018-09-10T17:01:33Z","updated_at":"2019-01-04T21:09:03Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"**Work at OpenJ9 to port to Mac:**\r\n\r\n@DanHeidinga We need to plan any changes to the user documentation that are required for the Mac port at OpenJ9. \r\n\r\n- update to the support topic, including platform support and build environment\r\n- across the doc we mention differences per platform. What differences will exist for Mac? \r\n    - supported options\r\n    - supported GC policies\r\n    - any limitations etc\r\n\r\nAs the work progresses, perhaps the team can add any relevant notes here please?"},"comment":{"url":"https://api.github.com/repos/eclipse/openj9-docs/issues/comments/451569120","html_url":"https://github.com/eclipse/openj9-docs/issues/82#issuecomment-451569120","issue_url":"https://api.github.com/repos/eclipse/openj9-docs/issues/82","id":451569120,"node_id":"MDEyOklzc3VlQ29tbWVudDQ1MTU2OTEyMA==","user":{"login":"babsingh","id":8634038,"node_id":"MDQ6VXNlcjg2MzQwMzg=","avatar_url":"https://avatars1.githubusercontent.com/u/8634038?v=4","gravatar_id":"","url":"https://api.github.com/users/babsingh","html_url":"https://github.com/babsingh","followers_url":"https://api.github.com/users/babsingh/followers","following_url":"https://api.github.com/users/babsingh/following{/other_user}","gists_url":"https://api.github.com/users/babsingh/gists{/gist_id}","starred_url":"https://api.github.com/users/babsingh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/babsingh/subscriptions","organizations_url":"https://api.github.com/users/babsingh/orgs","repos_url":"https://api.github.com/users/babsingh/repos","events_url":"https://api.github.com/users/babsingh/events{/privacy}","received_events_url":"https://api.github.com/users/babsingh/received_events","type":"User","site_admin":false},"created_at":"2019-01-04T21:09:03Z","updated_at":"2019-01-04T21:09:03Z","author_association":"NONE","body":"**Updated excel:** [macos-babneet.xlsx](https://github.com/eclipse/openj9-docs/files/2728431/macos-babneet.xlsx). I have filled column C (**macOS? yes/no**). I have used column D and F for questions/notes. Added Column E; it contains a link to the online documentation for each option.\r\n\r\nQuestions for @DanHeidinga or @pshipton -\r\n1. [-Xcheck:dump](https://www.eclipse.org/openj9/docs/xcheck/#dump) doesn't work on OSX because function `J9RASCheckDump` is unimplemented for OSX in OpenJ9. [-Xcheck:dump](https://www.eclipse.org/openj9/docs/xcheck/#dump) seems relevant for OSX. Do you guys agree? If so, I will open an OpenJ9 issue to add OSX support for `-Xcheck:dump`.\r\n2. Should [-Xnuma:none](https://www.eclipse.org/openj9/docs/xnumanone/) and [-XX:[+|-]InterleaveMemory](https://www.eclipse.org/openj9/docs/xxinterleavememory/) be disabled on OSX due to absence of NUMA support? \r\n   - OSX doesn't have NUMA support: https://news.ycombinator.com/item?id=9500592. \r\n   - Instead, OSX has a   thread affinity API:   https://developer.apple.com/library/archive/releasenotes/Performance/RN-AffinityAPI.   \r\n   - On Mac Pros with Xeon processors, QPI, Intel's implementation of NUMA, takes   place fully within the processor just as HyperTransport is AMDs.\r\n3.  Should [-XX:[+|-]IdleTuningCompactOnIdle](https://www.eclipse.org/openj9/docs/xxidletuningcompactonidle), [-XX:[+|-]IdleTuningGcOnIdle](https://www.eclipse.org/openj9/docs/xxidletuninggconidle),[-XX:IdleTuningMinFreeHeapOnIdle](https://www.eclipse.org/openj9/docs/xxidletuningminfreeheaponidle) and [-XX:IdleTuningMinIdleWaitTime](https://www.eclipse.org/openj9/docs/xxidletuningminidlewaittime) be supported on OSX? The first three options are used by the GC and enabled by the `J9VM_GC_IDLE_HEAP_MANAGER` flag. `J9VM_GC_IDLE_HEAP_MANAGER` is enabled on OSX since Linux spec files were used to create OSX spec files. The fourth option is always enabled, used by the JIT and related to the first three options. The online doc says that the four options are only supported on Linux. After looking at the code, all four options should work on OSX. I am not sure if we want to support these options on OSX.\r\n4. Currently, [-Xthr:cfsYield | noCfsYield](https://www.eclipse.org/openj9/docs/xthr/#cfsyield-nocfsyield-linux-only) is enabled on OSX. Since OSX doesn't have a Completely Fair Scheduler, this feature should be disabled on OSX. Created https://github.com/eclipse/openj9/pull/3921 to disable [-Xthr:cfsYield | noCfsYield](https://www.eclipse.org/openj9/docs/xthr/#cfsyield-nocfsyield-linux-only) on OSX.\r\n5. [-XtlhPrefetch](https://www.eclipse.org/openj9/docs/xtlhprefetch) is only supported on AIX and Windows. But, [-XtlhPrefetch](https://www.eclipse.org/openj9/docs/xtlhprefetch) gets accepted as cmdline option on Linux, OSX and other platforms. Should [-XtlhPrefetch](https://www.eclipse.org/openj9/docs/xtlhprefetch) be unrecognized on unsupported platforms?\r\n6. In the documentation of [-Xtrace](https://www.eclipse.org/openj9/docs/xtrace/#tracepoint-specification), there is a reference to **ibm_gpu** component, which represents class library graphics processing unit (GPU) native code (supported on Linux only). I am guessing **ibm_gpu** component won't be supported on OSX. Can you confirm this?\r\n7. Other than NLS messages, I couldn't find the source code or history related to [-Xrdbginfo](https://www.eclipse.org/openj9/docs/xrdbginfo/) in OpenJ9. What happens to the documentation of [-Xrdbginfo](https://www.eclipse.org/openj9/docs/xrdbginfo/)? Do we remove it or do we keep it with a note?\r\n8. For [-Xshareclasses](https://www.eclipse.org/openj9/docs/xshareclasses/), I have assumed that the Linux content applies to OSX. Is this assumption correct? Also, I have proposed that \"an OSX user may need to set, kern.sysv.shmmax and kern.sysv.shmall, for shared classes to work\".\r\n9. In the [-Xdump](https://www.eclipse.org/openj9/docs/xdump/#system-dumps-on-linux) documentation, there is a section named **System dumps on Linux** at the end. Should we add a section for **System dumps on OSX** since system dumps may not generate by default on OSX?\r\n\r\n\r\n\r\n\r\n\r\n\r\n \r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n"}}
{"actor":{"display_login":"babsingh"}}