<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >proc_dostring</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="sysctl interface" HREF="c2724.html#AEN2726"><LINK REL="PREVIOUS" TITLE="unregister_sysctl_table" HREF="r2793.html"><LINK REL="NEXT" TITLE="proc_dointvec" HREF="r2876.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="r2793.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="r2876.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="AEN2819" ></A ><SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >proc_dostring</SPAN ></SPAN ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN2823" ></A ><H2 >Name</H2 >proc_dostring -- read a string sysctl </DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN2826" ></A ><H2 >Synopsis</H2 ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN2828" ></A ><P ></P ><P ><CODE ><CODE CLASS="FUNCDEF" >int <TT CLASS="FUNCTION" >proc_dostring </TT ></CODE >(ctl_table * <TT CLASS="PARAMETER" ><I >table</I ></TT >, int <TT CLASS="PARAMETER" ><I >write</I ></TT >, struct file * <TT CLASS="PARAMETER" ><I >filp</I ></TT >, void * <TT CLASS="PARAMETER" ><I >buffer</I ></TT >, size_t * <TT CLASS="PARAMETER" ><I >lenp</I ></TT >);</CODE ></P ><P ></P ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN2842" ></A ><H2 >Arguments</H2 ><P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT ><TT CLASS="PARAMETER" ><I >table</I ></TT ></DT ><DD ><P > the sysctl table </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >write</I ></TT ></DT ><DD ><P > <TT CLASS="CONSTANT" >TRUE</TT > if this is a write to the sysctl file </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >filp</I ></TT ></DT ><DD ><P > the file structure </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >buffer</I ></TT ></DT ><DD ><P > the user buffer </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >lenp</I ></TT ></DT ><DD ><P > the size of the user buffer </P ></DD ></DL ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN2871" ></A ><H2 >Description</H2 ><P > Reads/writes a string from/to the user buffer. If the kernel buffer provided is not large enough to hold the string, the string is truncated. The copied string is <TT CLASS="CONSTANT" >NULL-terminated</TT >. If the string is being read by the user process, it is copied and a newline '\n' is added. It is truncated if the buffer is not large enough. </P ><P > Returns 0 on success. </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="r2793.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="r2876.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >unregister_sysctl_table</SPAN ></SPAN ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="c2724.html#AEN2726" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >proc_dointvec</SPAN ></SPAN ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >