diff options
Diffstat (limited to 'runtime/docs/html/copy_8c-source.html')
| -rw-r--r-- | runtime/docs/html/copy_8c-source.html | 186 |
1 files changed, 0 insertions, 186 deletions
diff --git a/runtime/docs/html/copy_8c-source.html b/runtime/docs/html/copy_8c-source.html deleted file mode 100644 index 273aa45c..00000000 --- a/runtime/docs/html/copy_8c-source.html +++ /dev/null @@ -1,186 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: copy.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>copy.c</h1><a href="copy_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _COPY_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _COPY_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="preprocessor">#include "<a class="code" href="string_8c.html">string.c</a>"</span> -00005 <span class="comment"></span> -00006 <span class="comment">/** @file copy.c</span> -00007 <span class="comment"> * @brief Functions to copy from user space.</span> -00008 <span class="comment"> */</span> -00009 <span class="comment"></span> -00010 <span class="comment">/** @addtogroup copy Functions to copy from user space.</span> -00011 <span class="comment"> * Functions to copy from user space.</span> -00012 <span class="comment"> * None of these functions will sleep (for example to allow pages</span> -00013 <span class="comment"> * to be swapped in). It is possible (although rare) that the data</span> -00014 <span class="comment"> * in user space will not present and these functions will return an error.</span> -00015 <span class="comment"> * @{</span> -00016 <span class="comment"> */</span> -00017 -00018 <span class="keywordtype">long</span> <a class="code" href="group__copy.html#ga0">_stp_strncpy_from_user</a>(<span class="keywordtype">char</span> *dst, <span class="keyword">const</span> <span class="keywordtype">char</span> __user *src, <span class="keywordtype">long</span> count); -00019 <span class="comment">//static long __stp_strncpy_from_user(char *dst, const char __user *src, long count);</span> -00020 -00021 <span class="preprocessor">#if defined (__i386__)</span> -00022 <span class="preprocessor"></span><span class="preprocessor">#define __stp_strncpy_from_user(dst,src,count,res) \</span> -00023 <span class="preprocessor">do { \</span> -00024 <span class="preprocessor"> int __d0, __d1, __d2; \</span> -00025 <span class="preprocessor"> __asm__ __volatile__( \</span> -00026 <span class="preprocessor"> " testl %1,%1\n" \</span> -00027 <span class="preprocessor"> " jz 2f\n" \</span> -00028 <span class="preprocessor"> "0: lodsb\n" \</span> -00029 <span class="preprocessor"> " stosb\n" \</span> -00030 <span class="preprocessor"> " testb %%al,%%al\n" \</span> -00031 <span class="preprocessor"> " jz 1f\n" \</span> -00032 <span class="preprocessor"> " decl %1\n" \</span> -00033 <span class="preprocessor"> " jnz 0b\n" \</span> -00034 <span class="preprocessor"> "1: subl %1,%0\n" \</span> -00035 <span class="preprocessor"> "2:\n" \</span> -00036 <span class="preprocessor"> ".section .fixup,\"ax\"\n" \</span> -00037 <span class="preprocessor"> "3: movl %5,%0\n" \</span> -00038 <span class="preprocessor"> " jmp 2b\n" \</span> -00039 <span class="preprocessor"> ".previous\n" \</span> -00040 <span class="preprocessor"> ".section __ex_table,\"a\"\n" \</span> -00041 <span class="preprocessor"> " .align 4\n" \</span> -00042 <span class="preprocessor"> " .long 0b,3b\n" \</span> -00043 <span class="preprocessor"> ".previous" \</span> -00044 <span class="preprocessor"> : "=d"(res), "=c"(count), "=&a" (__d0), "=&S" (__d1), \</span> -00045 <span class="preprocessor"> "=&D" (__d2) \</span> -00046 <span class="preprocessor"> : "i"(-EFAULT), "0"(count), "1"(count), "3"(src), "4"(dst) \</span> -00047 <span class="preprocessor"> : "memory"); \</span> -00048 <span class="preprocessor">} while (0)</span> -00049 <span class="preprocessor"></span><span class="preprocessor">#elif defined (__x86_64__)</span> -00050 <span class="preprocessor"></span><span class="preprocessor">#define __stp_strncpy_from_user(dst,src,count,res) \</span> -00051 <span class="preprocessor">do { \</span> -00052 <span class="preprocessor"> long __d0, __d1, __d2; \</span> -00053 <span class="preprocessor"> __asm__ __volatile__( \</span> -00054 <span class="preprocessor"> " testq %1,%1\n" \</span> -00055 <span class="preprocessor"> " jz 2f\n" \</span> -00056 <span class="preprocessor"> "0: lodsb\n" \</span> -00057 <span class="preprocessor"> " stosb\n" \</span> -00058 <span class="preprocessor"> " testb %%al,%%al\n" \</span> -00059 <span class="preprocessor"> " jz 1f\n" \</span> -00060 <span class="preprocessor"> " decq %1\n" \</span> -00061 <span class="preprocessor"> " jnz 0b\n" \</span> -00062 <span class="preprocessor"> "1: subq %1,%0\n" \</span> -00063 <span class="preprocessor"> "2:\n" \</span> -00064 <span class="preprocessor"> ".section .fixup,\"ax\"\n" \</span> -00065 <span class="preprocessor"> "3: movq %5,%0\n" \</span> -00066 <span class="preprocessor"> " jmp 2b\n" \</span> -00067 <span class="preprocessor"> ".previous\n" \</span> -00068 <span class="preprocessor"> ".section __ex_table,\"a\"\n" \</span> -00069 <span class="preprocessor"> " .align 8\n" \</span> -00070 <span class="preprocessor"> " .quad 0b,3b\n" \</span> -00071 <span class="preprocessor"> ".previous" \</span> -00072 <span class="preprocessor"> : "=r"(res), "=c"(count), "=&a" (__d0), "=&S" (__d1), \</span> -00073 <span class="preprocessor"> "=&D" (__d2) \</span> -00074 <span class="preprocessor"> : "i"(-EFAULT), "0"(count), "1"(count), "3"(src), "4"(dst) \</span> -00075 <span class="preprocessor"> : "memory"); \</span> -00076 <span class="preprocessor">} while (0)</span> -00077 <span class="preprocessor"></span><span class="preprocessor">#endif</span> -00078 <span class="preprocessor"></span><span class="comment"></span> -00079 <span class="comment">/** Copy a NULL-terminated string from userspace.</span> -00080 <span class="comment"> * On success, returns the length of the string (not including the trailing</span> -00081 <span class="comment"> * NULL).</span> -00082 <span class="comment"> *</span> -00083 <span class="comment"> * If access to userspace fails, returns -EFAULT (some data may have been</span> -00084 <span class="comment"> * copied).</span> -00085 <span class="comment"> * @param dst Destination address, in kernel space. This buffer must be at</span> -00086 <span class="comment"> * least <i>count</i> bytes long.</span> -00087 <span class="comment"> * @param src Source address, in user space.</span> -00088 <span class="comment"> * @param count Maximum number of bytes to copy, including the trailing NULL.</span> -00089 <span class="comment"> * </span> -00090 <span class="comment"> * If <i>count</i> is smaller than the length of the string, copies </span> -00091 <span class="comment"> * <i>count</i> bytes and returns <i>count</i>.</span> -00092 <span class="comment"> * @deprecated I can't think of why you wouldn't use _stp_string_from_user() instead.</span> -00093 <span class="comment"> */</span> -00094 -00095 <span class="keywordtype">long</span> -<a name="l00096"></a><a class="code" href="group__copy.html#ga0">00096</a> <a class="code" href="group__copy.html#ga0">_stp_strncpy_from_user</a>(<span class="keywordtype">char</span> *dst, <span class="keyword">const</span> <span class="keywordtype">char</span> __user *src, <span class="keywordtype">long</span> count) -00097 { -00098 <span class="keywordtype">long</span> res; -00099 __stp_strncpy_from_user(dst, src, count, res); -00100 <span class="keywordflow">return</span> res; -00101 } -00102 <span class="comment"></span> -00103 <span class="comment">/** Copy a String from userspace.</span> -00104 <span class="comment"> * Copies a string of up to \e count bytes from userspace into a String. </span> -00105 <span class="comment"> * If access to userspace fails, returns -EFAULT (some data may have been</span> -00106 <span class="comment"> * copied).</span> -00107 <span class="comment"> * @param str Destination String.</span> -00108 <span class="comment"> * @param src Source address, in user space.</span> -00109 <span class="comment"> * @param count Maximum number of bytes to copy, including the trailing NULL.</span> -00110 <span class="comment"> * </span> -00111 <span class="comment"> */</span> -00112 -<a name="l00113"></a><a class="code" href="group__copy.html#ga1">00113</a> <span class="keywordtype">void</span> <a class="code" href="group__copy.html#ga1">_stp_string_from_user</a> (String str, <span class="keyword">const</span> <span class="keywordtype">char</span> __user *src, <span class="keywordtype">long</span> count) -00114 { -00115 <span class="keywordtype">long</span> res; -00116 <span class="keywordflow">if</span> (count > <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str->len - 1) -00117 count = <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str->len - 1; -00118 __stp_strncpy_from_user(str->buf + str->len, src, count, res); -00119 <span class="keywordflow">if</span> (res > 0) { -00120 str->len += res; -00121 str->buf[str->len] = <span class="charliteral">'\0'</span>; -00122 } -00123 } -00124 <span class="comment"></span> -00125 <span class="comment">/** Copy a block of data from user space.</span> -00126 <span class="comment"> *</span> -00127 <span class="comment"> * If some data could not be copied, this function will pad the copied</span> -00128 <span class="comment"> * data to the requested size using zero bytes.</span> -00129 <span class="comment"></span> -00130 <span class="comment"> * @param dst Destination address, in kernel space.</span> -00131 <span class="comment"> * @param src Source address, in user space.</span> -00132 <span class="comment"> * @param count Number of bytes to copy.</span> -00133 <span class="comment"> * @return number of bytes that could not be copied. On success, </span> -00134 <span class="comment"> * this will be zero.</span> -00135 <span class="comment"> *</span> -00136 <span class="comment"> */</span> -00137 -00138 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> -<a name="l00139"></a><a class="code" href="group__copy.html#ga2">00139</a> <a class="code" href="group__copy.html#ga2">_stp_copy_from_user</a> (<span class="keywordtype">char</span> *dst, <span class="keyword">const</span> <span class="keywordtype">char</span> __user *src, <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> count) -00140 { -00141 <span class="keywordflow">return</span> __copy_from_user_inatomic(dst, src, count); -00142 } -00143 <span class="comment"></span> -00144 <span class="comment">/** Copy an argv from user space to a List.</span> -00145 <span class="comment"> *</span> -00146 <span class="comment"> * @param list A list.</span> -00147 <span class="comment"> * @param argv Source argv, in user space.</span> -00148 <span class="comment"> * @return number of elements in <i>list</i></span> -00149 <span class="comment"> *</span> -00150 <span class="comment"> * @b Example:</span> -00151 <span class="comment"> * @include argv.c</span> -00152 <span class="comment"> */</span> -00153 -<a name="l00154"></a><a class="code" href="group__copy.html#ga3">00154</a> <span class="keywordtype">int</span> <a class="code" href="group__copy.html#ga3">_stp_copy_argv_from_user</a> (<a class="code" href="group__maps.html#ga1">MAP</a> list, <span class="keywordtype">char</span> __user *__user *argv) -00155 { -00156 <span class="keywordtype">char</span> str[128]; -00157 <span class="keywordtype">char</span> __user *vstr; -00158 <span class="keywordtype">int</span> len; -00159 -00160 <span class="keywordflow">if</span> (argv) -00161 argv++; -00162 -00163 <span class="keywordflow">while</span> (argv != NULL) { -00164 <span class="keywordflow">if</span> (get_user (vstr, argv)) -00165 <span class="keywordflow">break</span>; -00166 -00167 <span class="keywordflow">if</span> (vstr == NULL) -00168 <span class="keywordflow">break</span>; -00169 -00170 len = <a class="code" href="group__copy.html#ga0">_stp_strncpy_from_user</a>(str, vstr, 128); -00171 str[len] = 0; -00172 <a class="code" href="group__lists.html#ga2">_stp_list_add_str</a> (list, str); -00173 argv++; -00174 } -00175 <span class="keywordflow">return</span> list->num; -00176 }<span class="comment"></span> -00177 <span class="comment">/** @} */</span> -00178 <span class="preprocessor">#endif </span><span class="comment">/* _COPY_C_ */</span> -</pre></div></body></html> |