<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >pm_send</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="The Linux Kernel API" HREF="book1.html"><LINK REL="UP" TITLE="Power Management" HREF="c11281.html"><LINK REL="PREVIOUS" TITLE="pm_unregister_all" HREF="r11351.html"><LINK REL="NEXT" TITLE="pm_send_all" HREF="r11425.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >The Linux Kernel API</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="r11351.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="r11425.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="AEN11377" ></A ><SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >pm_send</SPAN ></SPAN ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN11381" ></A ><H2 >Name</H2 >pm_send -- send request to a single device </DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN11384" ></A ><H2 >Synopsis</H2 ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN11386" ></A ><P ></P ><P ><CODE ><CODE CLASS="FUNCDEF" >int <TT CLASS="FUNCTION" >pm_send </TT ></CODE >(struct pm_dev * <TT CLASS="PARAMETER" ><I >dev</I ></TT >, pm_request_t <TT CLASS="PARAMETER" ><I >rqst</I ></TT >, void * <TT CLASS="PARAMETER" ><I >data</I ></TT >);</CODE ></P ><P ></P ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN11396" ></A ><H2 >Arguments</H2 ><P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT ><TT CLASS="PARAMETER" ><I >dev</I ></TT ></DT ><DD ><P > device to send to </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >rqst</I ></TT ></DT ><DD ><P > power management request </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >data</I ></TT ></DT ><DD ><P > data for the callback </P ></DD ></DL ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN11414" ></A ><H2 >Description</H2 ><P > Issue a power management request to a given device. The <TT CLASS="CONSTANT" >PM_SUSPEND</TT > and <TT CLASS="CONSTANT" >PM_RESUME</TT > events are handled specially. The data field must hold the intended next state. No call is made if the state matches. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN11419" ></A ><H2 >BUGS</H2 ><P > what stops two power management requests occuring in parallel and conflicting. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN11422" ></A ><H2 >WARNING</H2 ><P > Calling pm_send directly is not generally recommended, in paticular there is no locking against the pm_dev going away. The caller must maintain all needed locking or have 'inside knowledge' on the safety. Also remember that this function is not locked against pm_unregister. This means that you must handle SMP races on callback execution and unload yourself. </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="r11351.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="book1.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="r11425.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >pm_unregister_all</SPAN ></SPAN ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="c11281.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >pm_send_all</SPAN ></SPAN ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >