'\" t
.\"     Title: wimax_msg_alloc
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: July 2017
.\"    Manual: Linux Networking
.\"    Source: Kernel Hackers Manual 4.12.2
.\"  Language: English
.\"
.TH "WIMAX_MSG_ALLOC" "9" "July 2017" "Kernel Hackers Manual 4\&.12\&" "Linux Networking"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
wimax_msg_alloc \- Create a new skb for sending a message to userspace
.SH "SYNOPSIS"
.HP \w'struct\ sk_buff\ *\ wimax_msg_alloc('u
.BI "struct sk_buff * wimax_msg_alloc(struct\ wimax_dev\ *\ " "wimax_dev" ", const\ char\ *\ " "pipe_name" ", const\ void\ *\ " "msg" ", size_t\ " "size" ", gfp_t\ " "gfp_flags" ");"
.SH "ARGUMENTS"
.PP
\fIstruct wimax_dev * wimax_dev\fR
.RS 4
WiMAX device descriptor
.RE
.PP
\fIconst char * pipe_name\fR
.RS 4
"named pipe" the message will be sent to
.RE
.PP
\fIconst void * msg\fR
.RS 4
pointer to the message data to send
.RE
.PP
\fIsize_t size\fR
.RS 4
size of the message to send (in bytes), including the header\&.
.RE
.PP
\fIgfp_t gfp_flags\fR
.RS 4
flags for memory allocation\&.
.RE
.SH "RETURN"
.PP
\fB0\fR
if ok, negative errno code on error
.SH "DESCRIPTION"
.PP
.PP
Allocates an skb that will contain the message to send to user space over the messaging pipe and initializes it, copying the payload\&.
.PP
Once this call is done, you can deliver it with
\fBwimax_msg_send\fR\&.
.PP
IMPORTANT:
.PP
Don\*(Aqt use
\fBskb_push\fR/\fBskb_pull\fR/\fBskb_reserve\fR
on the skb, as
\fBwimax_msg_send\fR
depends on skb\->data being placed at the beginning of the user message\&.
.PP
Unlike other WiMAX stack calls, this call can be used way early, even before
\fBwimax_dev_add\fR
is called, as long as the wimax_dev\->net_dev pointer is set to point to a proper net_dev\&. This is so that drivers can use it early in case they need to send stuff around or communicate with user space\&.
.SH "COPYRIGHT"
.br