portugalfuturista/universalisos
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
universalisos/docs/html/driver-reference-manual/group__hlblk__init.html
Fábio Coutada 7855eab092 feat(import): Complete PikeOS 5.0 ecosystem import from devvm-arch 
MAJOR MILESTONE: Successfully imported complete PikeOS 5.0 ecosystem
from Virtual Machine 100 (devvm-arch) on gigabyte Proxmox server.

Import Summary:
- Source Code: 4.3GB, 63,441 files, 14,829 C/C++/H files
- Documentation: 78MB, 37+ PDF manuals covering all PikeOS aspects
- XSD Schemas: 1.8MB, 158 schema files for configuration/code generation
- Test Framework: Complete TFW infrastructure in src/tfw/

Key Components:
✅ Multi-architecture kernels (ARM v7/v8, PowerPC e500/e500mc/e5500, x86_64)
✅ Core source libraries (libstand, ssw, p4ext)
✅ Complete test framework with executables, includes, libraries
✅ 37+ comprehensive PDF documentation (installation, development, platform manuals)
✅ 158 XSD schemas for Eclipse-based code generation and configuration
✅ AUTOSAR/MISRA safety-critical compliance foundation
✅ Hardware virtualization support
✅ Eclipse IDE project configuration (.project, .cproject)

Documentation Categories:
- Installation & User Guides (pikeos-installation-guide.pdf, user manuals)
- Development References (kernel, driver, test framework manuals)
- API & Programming (C/C++ environments, native API extensions)
- Platform Manuals (ARM, PowerPC, x86 specific guides)
- CDK Documentation (gcc, binutils, ld, cpp internals)
- Release Notes (all components for 5.0.3)
- Specialized Topics (hardware virtualization, POSIX compliance)

Technical Achievements:
✅ Complete PikeOS 5.0 codebase across multiple processor architectures
✅ Safety-critical foundation with AUTOSAR/MISRA compliance
✅ Eclipse IDE integration with XSD-driven code generation pipeline
✅ Comprehensive test framework for validation and verification
✅ Complete documentation covering development, deployment, and optimization

Extraction Method:
- Source: VM 100 (devvm-arch) on gigabyte server (192.168.0.104)
- Method: Direct LVM disk mount via losetup, rsync transfer
- Size: Total 4.4GB extracted and organized

Next Phases:
- Phase 3: XSD Workflow Analysis (Day 8-10)
- Phase 4: Safety Standards Compliance Documentation (Day 11-12)
- Phase 5: Component Categorization (Day 13-14)
- Phase 6: Aurelio Brain Test (Day 15)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-06 21:01:41 +01:00

412 lines
23 KiB
HTML
Raw Permalink Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Initialization Services</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('group__hlblk__init.html','');});
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Initialization Services</div> </div>
</div><!--header-->
<div class="contents">
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>This section describes device initialization services provided by the BLK high level module. </p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gae643e5c8c23b58677b399e283d0d8ff4"><td class="memItemLeft" align="right" valign="top">P4_e_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hlblk__init.html#gae643e5c8c23b58677b399e283d0d8ff4">drv_hlblk_read_config</a> (<a class="el" href="group__file__manager.html#gaff07263d274d67db23dce2cdbfc5bd91">drv_char_file_t</a> *file, <a class="el" href="group__hlblk__types.html#ga76c2d7987b8fec592a12fc05586d4055">drv_hlblk_cfg_t</a> *cfg, <a class="el" href="group__drv__blk__bin__config.html#ga7814660c53a2f4ca960067689745eaaa">drv_blk_dev_config_t</a> *bin, <a class="el" href="group__hlblk__types.html#gaa1f73b2d421c5edc5a1e643f80ad7c83">drv_hlblk_partcfg_t</a> *partcfg)</td></tr>
<tr class="memdesc:gae643e5c8c23b58677b399e283d0d8ff4"><td class="mdescLeft">&#160;</td><td class="mdescRight">Prepares configuration structure of high level BLK device using configuration in properties and binary configuration if provided. <a href="#gae643e5c8c23b58677b399e283d0d8ff4">More...</a><br /></td></tr>
<tr class="separator:gae643e5c8c23b58677b399e283d0d8ff4"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga06055df16ada61d8cd93324aeb1b3d3e"><td class="memItemLeft" align="right" valign="top">P4_e_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hlblk__init.html#ga06055df16ada61d8cd93324aeb1b3d3e">drv_hlblk_dev_alloc</a> (<a class="el" href="group__file__manager.html#gaff07263d274d67db23dce2cdbfc5bd91">drv_char_file_t</a> *file, <a class="el" href="group__hlblk__types.html#gaa1f73b2d421c5edc5a1e643f80ad7c83">drv_hlblk_partcfg_t</a> *partcfg, <a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6">drv_hlblk_dev_t</a> **rhldev)</td></tr>
<tr class="memdesc:ga06055df16ada61d8cd93324aeb1b3d3e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Allocate high level BLK device. <a href="#ga06055df16ada61d8cd93324aeb1b3d3e">More...</a><br /></td></tr>
<tr class="separator:ga06055df16ada61d8cd93324aeb1b3d3e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga17c61566660e8959df20b1fe1bb3e2e7"><td class="memItemLeft" align="right" valign="top">P4_e_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hlblk__init.html#ga17c61566660e8959df20b1fe1bb3e2e7">drv_hlblk_dev_alloc_partition</a> (<a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6">drv_hlblk_dev_t</a> *hl_disk, P4_uint32_t partid, <a class="el" href="group__hlblk__types.html#gaa1f73b2d421c5edc5a1e643f80ad7c83">drv_hlblk_partcfg_t</a> *partcfg, <a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6">drv_hlblk_dev_t</a> **hl_partition)</td></tr>
<tr class="memdesc:ga17c61566660e8959df20b1fe1bb3e2e7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Allocates high-level BLK device for partition on the disk. <a href="#ga17c61566660e8959df20b1fe1bb3e2e7">More...</a><br /></td></tr>
<tr class="separator:ga17c61566660e8959df20b1fe1bb3e2e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga640df09d4b97505cdea3bd8658beffad"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hlblk__init.html#ga640df09d4b97505cdea3bd8658beffad">drv_hlblk_dev_disable</a> (<a class="el" href="group__file__manager.html#gaff07263d274d67db23dce2cdbfc5bd91">drv_char_file_t</a> *file)</td></tr>
<tr class="memdesc:ga640df09d4b97505cdea3bd8658beffad"><td class="mdescLeft">&#160;</td><td class="mdescRight">Disable processing high level requests on this file handle. <a href="#ga640df09d4b97505cdea3bd8658beffad">More...</a><br /></td></tr>
<tr class="separator:ga640df09d4b97505cdea3bd8658beffad"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga8676379ff1598ecf1c5e8f6ba62fd70c"><td class="memItemLeft" align="right" valign="top">P4_e_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hlblk__init.html#ga8676379ff1598ecf1c5e8f6ba62fd70c">drv_hlblk_dev_init</a> (<a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6">drv_hlblk_dev_t</a> *hldev)</td></tr>
<tr class="memdesc:ga8676379ff1598ecf1c5e8f6ba62fd70c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Initialize high level device. <a href="#ga8676379ff1598ecf1c5e8f6ba62fd70c">More...</a><br /></td></tr>
<tr class="separator:ga8676379ff1598ecf1c5e8f6ba62fd70c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga9cc7345486f6308aeafe45e737367265"><td class="memItemLeft" align="right" valign="top">P4_e_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hlblk__init.html#ga9cc7345486f6308aeafe45e737367265">drv_hlblk_set_partition</a> (<a class="el" href="group__hlblk__types.html#gaa1f73b2d421c5edc5a1e643f80ad7c83">drv_hlblk_partcfg_t</a> *partcfg, <a class="el" href="group__drv__blk__types.html#gaa06ef40123f04942a5d3e449611b2afd">drv_blk_area_off_t</a> offset, <a class="el" href="group__drv__blk__types.html#ga2a0f081064c7eacb3e6b675a1b289c30">drv_blk_area_len_t</a> size)</td></tr>
<tr class="memdesc:ga9cc7345486f6308aeafe45e737367265"><td class="mdescLeft">&#160;</td><td class="mdescRight">Updates accessible area of BLK device associated with HLBLK partition configuration. <a href="#ga9cc7345486f6308aeafe45e737367265">More...</a><br /></td></tr>
<tr class="separator:ga9cc7345486f6308aeafe45e737367265"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<h2 class="groupheader">Function Documentation</h2>
<a id="gae643e5c8c23b58677b399e283d0d8ff4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae643e5c8c23b58677b399e283d0d8ff4">&#9670;&nbsp;</a></span>drv_hlblk_read_config()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">P4_e_t drv_hlblk_read_config </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__file__manager.html#gaff07263d274d67db23dce2cdbfc5bd91">drv_char_file_t</a> *&#160;</td>
<td class="paramname"><em>file</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#ga76c2d7987b8fec592a12fc05586d4055">drv_hlblk_cfg_t</a> *&#160;</td>
<td class="paramname"><em>cfg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__drv__blk__bin__config.html#ga7814660c53a2f4ca960067689745eaaa">drv_blk_dev_config_t</a> *&#160;</td>
<td class="paramname"><em>bin</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#gaa1f73b2d421c5edc5a1e643f80ad7c83">drv_hlblk_partcfg_t</a> *&#160;</td>
<td class="paramname"><em>partcfg</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Prepares configuration structure of high level BLK device using configuration in properties and binary configuration if provided. </p>
<p>This function reads configuration of high level device and prepares drv_hlblk_partcfg_t structure which is needed for <a class="el" href="group__hlblk__init.html#ga06055df16ada61d8cd93324aeb1b3d3e" title="Allocate high level BLK device. ">drv_hlblk_dev_alloc()</a> and <a class="el" href="group__hlblk__init.html#ga17c61566660e8959df20b1fe1bb3e2e7" title="Allocates high-level BLK device for partition on the disk. ">drv_hlblk_dev_alloc_partition()</a>.</p>
<p>Content of <em>partcfg</em> can be adjusted after return of this call if needed.</p>
<dl class="section return"><dt>Returns</dt><dd></dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">P4_E_OK</td><td>On success </td></tr>
<tr><td class="paramname">P4_E_INVAL</td><td>If invalid arguments are provided. </td></tr>
</table>
</dd>
</dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">file</td><td>IN: Logical device file (or NULL for dynamic device). </td></tr>
<tr><td class="paramname">cfg</td><td>IN: Configuration of BLK device. </td></tr>
<tr><td class="paramname">bin</td><td>IN: Optional binary configuration of BLK device. If NULL is provided and <em>file</em> defines a cname, then configuration from properties is read. </td></tr>
<tr><td class="paramname">partcfg</td><td>OUT: Configuration of BLK device descriptor. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga06055df16ada61d8cd93324aeb1b3d3e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga06055df16ada61d8cd93324aeb1b3d3e">&#9670;&nbsp;</a></span>drv_hlblk_dev_alloc()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">P4_e_t drv_hlblk_dev_alloc </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__file__manager.html#gaff07263d274d67db23dce2cdbfc5bd91">drv_char_file_t</a> *&#160;</td>
<td class="paramname"><em>file</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#gaa1f73b2d421c5edc5a1e643f80ad7c83">drv_hlblk_partcfg_t</a> *&#160;</td>
<td class="paramname"><em>partcfg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6">drv_hlblk_dev_t</a> **&#160;</td>
<td class="paramname"><em>rhldev</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Allocate high level BLK device. </p>
<p>Then high level device and configured number of client session descriptors are allocated. A pointer to partition configuration <em>partcfg</em> is saved into partcfg of <a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6" title="High level device descriptor. ">drv_hlblk_dev_t</a>.</p>
<p>This function is supposed to be called from init_logic_dev() handler.</p>
<dl class="section return"><dt>Returns</dt><dd></dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">P4_E_OK</td><td>On success </td></tr>
<tr><td class="paramname">P4_E_INVAL</td><td>If invalid arguments are provided. </td></tr>
<tr><td class="paramname">P4_E_OOMEM</td><td>The provider does not have sufficient memory </td></tr>
<tr><td class="paramname">P4_E_CONFIG</td><td>The provider detected a configuration error </td></tr>
</table>
</dd>
</dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">file</td><td>IN: File handle of the device. </td></tr>
<tr><td class="paramname">partcfg</td><td>IN: Configuration of High-level BLK device. </td></tr>
<tr><td class="paramname">rhldev</td><td>OUT: Allocated High-level BLK device descriptor. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga17c61566660e8959df20b1fe1bb3e2e7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga17c61566660e8959df20b1fe1bb3e2e7">&#9670;&nbsp;</a></span>drv_hlblk_dev_alloc_partition()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">P4_e_t drv_hlblk_dev_alloc_partition </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6">drv_hlblk_dev_t</a> *&#160;</td>
<td class="paramname"><em>hl_disk</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">P4_uint32_t&#160;</td>
<td class="paramname"><em>partid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#gaa1f73b2d421c5edc5a1e643f80ad7c83">drv_hlblk_partcfg_t</a> *&#160;</td>
<td class="paramname"><em>partcfg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6">drv_hlblk_dev_t</a> **&#160;</td>
<td class="paramname"><em>hl_partition</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Allocates high-level BLK device for partition on the disk. </p>
<p>This function can be used to allocate high level BLK device for partition that is not configured in the properties and thus for which DDK does not allocate logical device.</p>
<p>It allocates new logical device structure, registers it to DDK as char file and allocates HLBLK device for new partition.</p>
<p>Name of created partition is composed by concatenating device name with double colon followed by partition ID number (e.g. blk0:1).</p>
<p>New partitions inhertits following properties of parent's logical device: timeouts, io, fflags and shared flag</p>
<dl class="section return"><dt>Returns</dt><dd></dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">P4_E_OK</td><td>On success </td></tr>
<tr><td class="paramname">P4_E_OOMEM</td><td>If not able to allocate logical device descriptor </td></tr>
<tr><td class="paramname">other</td><td>See <a class="el" href="group__file__manager.html#ga87eaa1f935a85625629bce07cf258a04" title="Register a device file in the driver&#39;s name space. ">drv_char_file_register()</a> </td></tr>
<tr><td class="paramname">other</td><td>See <a class="el" href="group__hlblk__init.html#ga06055df16ada61d8cd93324aeb1b3d3e" title="Allocate high level BLK device. ">drv_hlblk_dev_alloc()</a> </td></tr>
</table>
</dd>
</dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">hl_disk</td><td>IN: Disk device to allocate new partition on. </td></tr>
<tr><td class="paramname">partid</td><td>IN: Numerical ID of partition </td></tr>
<tr><td class="paramname">partcfg</td><td>IN: Configuration of High-level BLK device. </td></tr>
<tr><td class="paramname">hl_partition</td><td>OUT: Allocated High-Level BLK device for partition. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga640df09d4b97505cdea3bd8658beffad"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga640df09d4b97505cdea3bd8658beffad">&#9670;&nbsp;</a></span>drv_hlblk_dev_disable()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void drv_hlblk_dev_disable </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__file__manager.html#gaff07263d274d67db23dce2cdbfc5bd91">drv_char_file_t</a> *&#160;</td>
<td class="paramname"><em>file</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Disable processing high level requests on this file handle. </p>
<p>This function disables device configured in properties from processing by High Level BLK layer. for example if device is not available.</p>
<p>This function is supposed to be called from init_logic_dev() handler, and it can be called without regard of previous calls to <a class="el" href="group__hlblk__init.html#ga06055df16ada61d8cd93324aeb1b3d3e" title="Allocate high level BLK device. ">drv_hlblk_dev_alloc()</a> or <a class="el" href="group__hlblk__init.html#ga8676379ff1598ecf1c5e8f6ba62fd70c" title="Initialize high level device. ">drv_hlblk_dev_init()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">file</td><td>IN: File handle of the device. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga8676379ff1598ecf1c5e8f6ba62fd70c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8676379ff1598ecf1c5e8f6ba62fd70c">&#9670;&nbsp;</a></span>drv_hlblk_dev_init()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">P4_e_t drv_hlblk_dev_init </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6">drv_hlblk_dev_t</a> *&#160;</td>
<td class="paramname"><em>hldev</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize high level device. </p>
<p><br />
May invoke call backs in the low level driver.</p>
<p>This function is supposed to be called from init_logic_dev() handler.</p>
<dl class="section return"><dt>Returns</dt><dd></dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">P4_E_OK</td><td>On success </td></tr>
<tr><td class="paramname">P4_E_INVAL</td><td>If invalid arguments are provided, or if ll_ops of <a class="el" href="group__hlblk__types.html#ga099eeaaa817155cd9b48f445d057d9e6" title="High level device descriptor. ">drv_hlblk_dev_t</a> is not set, or if get_info or read operation of <a class="el" href="group__hlblk__types.html#ga54313b414a498155a842afd41e4be7ba" title="Logical device entry point descriptor. ">drv_hlblk_ll_ops_t</a> are not set. </td></tr>
<tr><td class="paramname">P4_E_OOMEM</td><td>The provider does not have sufficient memory </td></tr>
<tr><td class="paramname">P4_E_CONFIG</td><td>The provider detected a configuration error </td></tr>
</table>
</dd>
</dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">hldev</td><td>IN: High-level BLK device descriptor. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga9cc7345486f6308aeafe45e737367265"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9cc7345486f6308aeafe45e737367265">&#9670;&nbsp;</a></span>drv_hlblk_set_partition()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">P4_e_t drv_hlblk_set_partition </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__hlblk__types.html#gaa1f73b2d421c5edc5a1e643f80ad7c83">drv_hlblk_partcfg_t</a> *&#160;</td>
<td class="paramname"><em>partcfg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__drv__blk__types.html#gaa06ef40123f04942a5d3e449611b2afd">drv_blk_area_off_t</a>&#160;</td>
<td class="paramname"><em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__drv__blk__types.html#ga2a0f081064c7eacb3e6b675a1b289c30">drv_blk_area_len_t</a>&#160;</td>
<td class="paramname"><em>size</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Updates accessible area of BLK device associated with HLBLK partition configuration. </p>
<p>This functionality is used to set device partitions.</p>
<dl class="section return"><dt>Returns</dt><dd></dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">P4_E_OK</td><td>On success </td></tr>
<tr><td class="paramname">P4_E_CONFIG</td><td>On invalid partition configuration </td></tr>
</table>
</dd>
</dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">partcfg</td><td>INOUT: Partition configuration of HLBLK device. </td></tr>
<tr><td class="paramname">offset</td><td>IN: Offset of partition within device in bytes </td></tr>
<tr><td class="paramname">size</td><td>IN: Size of partition in bytes </td></tr>
</table>
</dd>
</dl>
</div>
</div>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="footer">(C) Copyright SYSGO AG</li>
</ul>
</div>
</body>
</html>
Reference in a new issue View git blame Copy permalink