From f3da91de4e676e8a9411bebe74c530f35cc48257 Mon Sep 17 00:00:00 2001
From: pensun <Peng.Sun@amd.com>
Date: Tue, 24 Jan 2017 22:30:36 -0600
Subject: [PATCH] Initial commit on hip_bugs markdown doc

Change-Id: I5a6915337b8664cfed9eaee9443c6e4406348574
---
 docs/markdown/hip_bugs.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 docs/markdown/hip_bugs.md

diff --git a/docs/markdown/hip_bugs.md b/docs/markdown/hip_bugs.md
new file mode 100644
index 0000000000..0bece74974
--- /dev/null
+++ b/docs/markdown/hip_bugs.md
@@ -0,0 +1,24 @@
+# HIP Bugs 
+
+<!-- toc -->
+
+- [Errors related to undefined reference to `__hcLaunchKernel__***__grid_launch_parm**](#error-undefined-reference)
+
+<!-- tocstop -->
+
+### Errors related to undefined reference to `__hcLaunchKernel__***__grid_launch_parm**
+
+Some common code practices may lead to hipcc generating a error with the form :
+undefined reference to `__hcLaunchKernel__ZN15vecAddNamespace6vecAddIidEEv16grid_launch_parmPT0_S3_S3_T_
+
+To workaround, try:
+- Avoid calling hcLaunchKernel from a function with the __host__ attribute
+__host__ MyFunc(…) {
+hipLaunchKernel(myKernel, …)
+- Avoid use of static with kernel definition:
+static __global__ MyKernel 
+- Avoid defining kernels in anonymous namespace
+namespace {
+__global__ MyKernel …
+- Avoid calling member functions 
+