TOsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget(/translations/zh_CN/userspace-api/dcdbasmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/zh_TW/userspace-api/dcdbasmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/it_IT/userspace-api/dcdbasmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/ja_JP/userspace-api/dcdbasmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/ko_KR/userspace-api/dcdbasmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/sp_SP/userspace-api/dcdbasmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h#Dell Systems Management Base Driverh]h#Dell Systems Management Base Driver}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhB/var/lib/git/docbuild/linux/Documentation/userspace-api/dcdbas.rsthKubh)}(hhh](h)}(hOverviewh]hOverview}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hXThe Dell Systems Management Base Driver provides a sysfs interface for systems management software such as Dell OpenManage to perform system management interrupts and host control actions (system power cycle or power off after OS shutdown) on certain Dell systems.h]hXThe Dell Systems Management Base Driver provides a sysfs interface for systems management software such as Dell OpenManage to perform system management interrupts and host control actions (system power cycle or power off after OS shutdown) on certain Dell systems.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hXLDell OpenManage requires this driver on the following Dell PowerEdge systems: 300, 1300, 1400, 400SC, 500SC, 1500SC, 1550, 600SC, 1600SC, 650, 1655MC, 700, and 750. Other Dell software such as the open source libsmbios project is expected to make use of this driver, and it may include the use of this driver on other Dell systems.h]hXLDell OpenManage requires this driver on the following Dell PowerEdge systems: 300, 1300, 1400, 400SC, 500SC, 1500SC, 1550, 600SC, 1600SC, 650, 1655MC, 700, and 750. Other Dell software such as the open source libsmbios project is expected to make use of this driver, and it may include the use of this driver on other Dell systems.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hThe Dell libsmbios project aims towards providing access to as much BIOS information as possible. See http://linux.dell.com/libsmbios/main/ for more information about the libsmbios project.h](hgThe Dell libsmbios project aims towards providing access to as much BIOS information as possible. See }(hhhhhNhNubh reference)}(h%http://linux.dell.com/libsmbios/main/h]h%http://linux.dell.com/libsmbios/main/}(hhhhhNhNubah}(h]h ]h"]h$]h&]refurihuh1hhhubh2 for more information about the libsmbios project.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]overviewah ]h"]overviewah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hSystem Management Interrupth]hSystem Management Interrupt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hXOn some Dell systems, systems management software must access certain management information via a system management interrupt (SMI). The SMI data buffer must reside in 32-bit address space, and the physical address of the buffer is required for the SMI. The driver maintains the memory required for the SMI and provides a way for the application to generate the SMI. The driver creates the following sysfs entries for systems management software to perform these system management interrupts::h]hXOn some Dell systems, systems management software must access certain management information via a system management interrupt (SMI). The SMI data buffer must reside in 32-bit address space, and the physical address of the buffer is required for the SMI. The driver maintains the memory required for the SMI and provides a way for the application to generate the SMI. The driver creates the following sysfs entries for systems management software to perform these system management interrupts:}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh literal_block)}(h/sys/devices/platform/dcdbas/smi_data /sys/devices/platform/dcdbas/smi_data_buf_phys_addr /sys/devices/platform/dcdbas/smi_data_buf_size /sys/devices/platform/dcdbas/smi_requesth]h/sys/devices/platform/dcdbas/smi_data /sys/devices/platform/dcdbas/smi_data_buf_phys_addr /sys/devices/platform/dcdbas/smi_data_buf_size /sys/devices/platform/dcdbas/smi_request}hj2sbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1j0hhhK#hjhhubh)}(h`Systems management software must perform the following steps to execute a SMI using this driver:h]h`Systems management software must perform the following steps to execute a SMI using this driver:}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK(hjhhubhenumerated_list)}(hhh](h list_item)}(hLock smi_data.h]h)}(hjYh]hLock smi_data.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjWubah}(h]h ]h"]h$]h&]uh1jUhjRhhhhhNubjV)}(h,Write system management command to smi_data.h]h)}(hjph]h,Write system management command to smi_data.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hjnubah}(h]h ]h"]h$]h&]uh1jUhjRhhhhhNubjV)}(hZWrite "1" to smi_request to generate a calling interface SMI or "2" to generate a raw SMI.h]h)}(hZWrite "1" to smi_request to generate a calling interface SMI or "2" to generate a raw SMI.h]hbWrite “1” to smi_request to generate a calling interface SMI or “2” to generate a raw SMI.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjubah}(h]h ]h"]h$]h&]uh1jUhjRhhhhhNubjV)}(h6Read system management command response from smi_data.h]h)}(hjh]h6Read system management command response from smi_data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjubah}(h]h ]h"]h$]h&]uh1jUhjRhhhhhNubjV)}(hUnlock smi_data. h]h)}(hUnlock smi_data.h]hUnlock smi_data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1jUhjRhhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix)uh1jPhjhhhhhK+ubeh}(h]system-management-interruptah ]h"]system management interruptah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hHost Control Actionh]hHost Control Action}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK4ubh)}(hX)Dell OpenManage supports a host control feature that allows the administrator to perform a power cycle or power off of the system after the OS has finished shutting down. On some Dell systems, this host control feature requires that a driver perform a SMI after the OS has finished shutting down.h]hX)Dell OpenManage supports a host control feature that allows the administrator to perform a power cycle or power off of the system after the OS has finished shutting down. On some Dell systems, this host control feature requires that a driver perform a SMI after the OS has finished shutting down.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjhhubh)}(hThe driver creates the following sysfs entries for systems management software to schedule the driver to perform a power cycle or power off host control action after the system has finished shutting down:h]hThe driver creates the following sysfs entries for systems management software to schedule the driver to perform a power cycle or power off host control action after the system has finished shutting down:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hjhhubh)}(h/sys/devices/platform/dcdbas/host_control_action /sys/devices/platform/dcdbas/host_control_smi_type /sys/devices/platform/dcdbas/host_control_on_shutdownh]h/sys/devices/platform/dcdbas/host_control_action /sys/devices/platform/dcdbas/host_control_smi_type /sys/devices/platform/dcdbas/host_control_on_shutdown}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjhhubh)}(hyDell OpenManage performs the following steps to execute a power cycle or power off host control action using this driver:h]hyDell OpenManage performs the following steps to execute a power cycle or power off host control action using this driver:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjhhubjQ)}(hhh](jV)}(hAWrite host control action to be performed to host_control_action.h]h)}(hj-h]hAWrite host control action to be performed to host_control_action.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhj+ubah}(h]h ]h"]h$]h&]uh1jUhj(hhhhhNubjV)}(hHWrite type of SMI that driver needs to perform to host_control_smi_type.h]h)}(hjDh]hHWrite type of SMI that driver needs to perform to host_control_smi_type.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjBubah}(h]h ]h"]h$]h&]uh1jUhj(hhhhhNubjV)}(hDWrite "1" to host_control_on_shutdown to enable host control action.h]h)}(hj[h]hHWrite “1” to host_control_on_shutdown to enable host control action.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjYubah}(h]h ]h"]h$]h&]uh1jUhj(hhhhhNubjV)}(hzInitiate OS shutdown. (Driver will perform host control SMI when it is notified that the OS has finished shutting down.) h]h)}(hxInitiate OS shutdown. (Driver will perform host control SMI when it is notified that the OS has finished shutting down.)h]hxInitiate OS shutdown. (Driver will perform host control SMI when it is notified that the OS has finished shutting down.)}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjpubah}(h]h ]h"]h$]h&]uh1jUhj(hhhhhNubeh}(h]h ]h"]h$]h&]jjjhjjuh1jPhjhhhhhKFubeh}(h]host-control-actionah ]h"]host control actionah$]h&]uh1hhhhhhhhK4ubh)}(hhh](h)}(hHost Control SMI Typeh]hHost Control SMI Type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKOubh)}(hThe following table shows the value to write to host_control_smi_type to perform a power cycle or power off host control action:h]hThe following table shows the value to write to host_control_smi_type to perform a power cycle or power off host control action:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubhthead)}(hhh]hrow)}(hhh](hentry)}(hhh]h)}(hPowerEdge Systemh]hPowerEdge System}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKUhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hHost Control SMI Typeh]hHost Control SMI Type}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKUhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubhtbody)}(hhh](j)}(hhh](j)}(hhh]h)}(h300h]h300}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhj#ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(hHC_SMITYPE_TYPE1h]hHC_SMITYPE_TYPE1}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhj:ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1300h]h1300}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjZubah}(h]h ]h"]h$]h&]uh1jhjWubj)}(hhh]h)}(hHC_SMITYPE_TYPE1h]hHC_SMITYPE_TYPE1}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjqubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1400h]h1400}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hHC_SMITYPE_TYPE2h]hHC_SMITYPE_TYPE2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h500SCh]h500SC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKZhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hHC_SMITYPE_TYPE2h]hHC_SMITYPE_TYPE2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKZhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1500SCh]h1500SC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hHC_SMITYPE_TYPE2h]hHC_SMITYPE_TYPE2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1550h]h1550}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hj6ubah}(h]h ]h"]h$]h&]uh1jhj3ubj)}(hhh]h)}(hHC_SMITYPE_TYPE2h]hHC_SMITYPE_TYPE2}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hjMubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h600SCh]h600SC}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hjmubah}(h]h ]h"]h$]h&]uh1jhjjubj)}(hhh]h)}(hHC_SMITYPE_TYPE2h]hHC_SMITYPE_TYPE2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1600SCh]h1600SC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hHC_SMITYPE_TYPE2h]hHC_SMITYPE_TYPE2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h650h]h650}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK_hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hHC_SMITYPE_TYPE2h]hHC_SMITYPE_TYPE2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK_hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1655MCh]h1655MC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hHC_SMITYPE_TYPE2h]hHC_SMITYPE_TYPE2}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hj)ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h700h]h700}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahjIubah}(h]h ]h"]h$]h&]uh1jhjFubj)}(hhh]h)}(hHC_SMITYPE_TYPE3h]hHC_SMITYPE_TYPE3}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahj`ubah}(h]h ]h"]h$]h&]uh1jhjFubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h750h]h750}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1jhj}ubj)}(hhh]h)}(hHC_SMITYPE_TYPE3h]hHC_SMITYPE_TYPE3}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]host-control-smi-typeah ]h"]host control smi typeah$]h&]uh1hhhhhhhhKOubeh}(h]#dell-systems-management-base-driverah ]h"]#dell systems management base driverah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jjjj jjjjjju nametypes}(jjjjjuh}(jhj hjjjjjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.