doc/html/ref/compat-uitron-system-mgmt-functions.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >         System Management Functions</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="µITRON API"
  23 HREF="compat-uitron-microitron-api.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Time Management Functions"
  26 HREF="compat-uitron-time-mgmt-functions.html"><LINK
  27 REL="NEXT"
  28 TITLE="   Network Support Functions"
  29 HREF="compat-uitron-network-support-functions.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="compat-uitron-time-mgmt-functions.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 32. &micro;ITRON API</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="compat-uitron-network-support-functions.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="COMPAT-UITRON-SYSTEM-MGMT-FUNCTIONS">System Management Functions</H1
  86 ><P
  87 >These functions are fully supported in this release:
  88         </P
  89 ><TABLE
  90 BORDER="5"
  91 BGCOLOR="#E0E0F0"
  92 WIDTH="70%"
  93 ><TR
  94 ><TD
  95 ><PRE
  96 CLASS="PROGRAMLISTING"
  97 >ER <TT
  98 CLASS="FUNCTION"
  99 >get_ver</TT
 100 >(
 101     T_VER *<SPAN
 102 CLASS="emphasis"
 103 ><I
 104 CLASS="EMPHASIS"
 105 >pk_ver</I
 106 ></SPAN
 107 > )</PRE
 108 ></TD
 109 ></TR
 110 ></TABLE
 111 ><TABLE
 112 BORDER="5"
 113 BGCOLOR="#E0E0F0"
 114 WIDTH="70%"
 115 ><TR
 116 ><TD
 117 ><PRE
 118 CLASS="PROGRAMLISTING"
 119 >ER <TT
 120 CLASS="FUNCTION"
 121 >ref_sys</TT
 122 >(
 123     T_RSYS *<SPAN
 124 CLASS="emphasis"
 125 ><I
 126 CLASS="EMPHASIS"
 127 >pk_rsys</I
 128 ></SPAN
 129 > )</PRE
 130 ></TD
 131 ></TR
 132 ></TABLE
 133 ><TABLE
 134 BORDER="5"
 135 BGCOLOR="#E0E0F0"
 136 WIDTH="70%"
 137 ><TR
 138 ><TD
 139 ><PRE
 140 CLASS="PROGRAMLISTING"
 141 >ER <TT
 142 CLASS="FUNCTION"
 143 >ref_cfg</TT
 144 >(
 145     T_RCFG *<SPAN
 146 CLASS="emphasis"
 147 ><I
 148 CLASS="EMPHASIS"
 149 >pk_rcfg</I
 150 ></SPAN
 151 > )</PRE
 152 ></TD
 153 ></TR
 154 ></TABLE
 155 ><P
 156 >Note that the information returned by each of these calls
 157 may be configured to match the user's own versioning system,
 158 and the values supplied by the default configuration may be inappropriate. </P
 159 ><P
 160 >These functions are not supported in this release: </P
 161 ><TABLE
 162 BORDER="5"
 163 BGCOLOR="#E0E0F0"
 164 WIDTH="70%"
 165 ><TR
 166 ><TD
 167 ><PRE
 168 CLASS="PROGRAMLISTING"
 169 >ER <TT
 170 CLASS="FUNCTION"
 171 >def_svc</TT
 172 >(
 173     FN <SPAN
 174 CLASS="emphasis"
 175 ><I
 176 CLASS="EMPHASIS"
 177 >s_fncd,</I
 178 ></SPAN
 179 >
 180     T_DSVC *<SPAN
 181 CLASS="emphasis"
 182 ><I
 183 CLASS="EMPHASIS"
 184 >pk_dsvc</I
 185 ></SPAN
 186 > )</PRE
 187 ></TD
 188 ></TR
 189 ></TABLE
 190 ><TABLE
 191 BORDER="5"
 192 BGCOLOR="#E0E0F0"
 193 WIDTH="70%"
 194 ><TR
 195 ><TD
 196 ><PRE
 197 CLASS="PROGRAMLISTING"
 198 >ER <TT
 199 CLASS="FUNCTION"
 200 >def_exc</TT
 201 >(
 202     UINT <SPAN
 203 CLASS="emphasis"
 204 ><I
 205 CLASS="EMPHASIS"
 206 >exckind,</I
 207 ></SPAN
 208 >
 209     T_DEXC *<SPAN
 210 CLASS="emphasis"
 211 ><I
 212 CLASS="EMPHASIS"
 213 >pk_dexc</I
 214 ></SPAN
 215 > )</PRE
 216 ></TD
 217 ></TR
 218 ></TABLE
 219 ><DIV
 220 CLASS="SECT2"
 221 ><H2
 222 CLASS="SECT2"
 223 ><A
 224 NAME="AEN14067">Error checking</H2
 225 ><P
 226 >The following conditions are only checked for, and
 227             only return errors if
 228
 229 <TT
 230 CLASS="LITERAL"
 231 >CYGSEM_UITRON_BAD_PARAMS_RETURN_ERRORS</TT
 232 >
 233  is enabled: </P
 234 ><P
 235 ></P
 236 ><UL
 237 ><LI
 238 ><P
 239 >return value pointer in all calls is a valid
 240               pointer, or E_PAR</P
 241 ></LI
 242 ></UL
 243 ></DIV
 244 ></DIV
 245 ><DIV
 246 CLASS="NAVFOOTER"
 247 ><HR
 248 ALIGN="LEFT"
 249 WIDTH="100%"><TABLE
 250 SUMMARY="Footer navigation table"
 251 WIDTH="100%"
 252 BORDER="0"
 253 CELLPADDING="0"
 254 CELLSPACING="0"
 255 ><TR
 256 ><TD
 257 WIDTH="33%"
 258 ALIGN="left"
 259 VALIGN="top"
 260 ><A
 261 HREF="compat-uitron-time-mgmt-functions.html"
 262 ACCESSKEY="P"
 263 >Prev</A
 264 ></TD
 265 ><TD
 266 WIDTH="34%"
 267 ALIGN="center"
 268 VALIGN="top"
 269 ><A
 270 HREF="ecos-ref.html"
 271 ACCESSKEY="H"
 272 >Home</A
 273 ></TD
 274 ><TD
 275 WIDTH="33%"
 276 ALIGN="right"
 277 VALIGN="top"
 278 ><A
 279 HREF="compat-uitron-network-support-functions.html"
 280 ACCESSKEY="N"
 281 >Next</A
 282 ></TD
 283 ></TR
 284 ><TR
 285 ><TD
 286 WIDTH="33%"
 287 ALIGN="left"
 288 VALIGN="top"
 289 >Time Management Functions</TD
 290 ><TD
 291 WIDTH="34%"
 292 ALIGN="center"
 293 VALIGN="top"
 294 ><A
 295 HREF="compat-uitron-microitron-api.html"
 296 ACCESSKEY="U"
 297 >Up</A
 298 ></TD
 299 ><TD
 300 WIDTH="33%"
 301 ALIGN="right"
 302 VALIGN="top"
 303 >Network Support Functions</TD
 304 ></TR
 305 ></TABLE
 306 ></DIV
 307 ></BODY
 308 ></HTML
 309 >