blob: 79afb626e1668981beaa740b4e7d618f22ab194d [file] [log] [blame]
Vitaly Kuznetsov14b50f82015-04-11 18:07:51 -07001/*
2 * Kernel/userspace transport abstraction for Hyper-V util driver.
3 *
4 * Copyright (C) 2015, Vitaly Kuznetsov <vkuznets@redhat.com>
5 *
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License version 2 as published
8 * by the Free Software Foundation.
9 *
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
13 * NON INFRINGEMENT. See the GNU General Public License for more
14 * details.
15 *
16 */
17
18#ifndef _HV_UTILS_TRANSPORT_H
19#define _HV_UTILS_TRANSPORT_H
20
21#include <linux/connector.h>
22#include <linux/miscdevice.h>
23
24enum hvutil_transport_mode {
25 HVUTIL_TRANSPORT_INIT = 0,
26 HVUTIL_TRANSPORT_NETLINK,
27 HVUTIL_TRANSPORT_CHARDEV,
Vitaly Kuznetsova1502562015-12-14 19:01:55 -080028 HVUTIL_TRANSPORT_DESTROY,
Vitaly Kuznetsov14b50f82015-04-11 18:07:51 -070029};
30
31struct hvutil_transport {
32 int mode; /* hvutil_transport_mode */
33 struct file_operations fops; /* file operations */
34 struct miscdevice mdev; /* misc device */
35 struct cb_id cn_id; /* CN_*_IDX/CN_*_VAL */
36 struct list_head list; /* hvt_list */
37 int (*on_msg)(void *, int); /* callback on new user message */
38 void (*on_reset)(void); /* callback when userspace drops */
Vitaly Kuznetsove0fa3e52016-06-09 17:08:57 -070039 void (*on_read)(void); /* callback on message read */
Vitaly Kuznetsov14b50f82015-04-11 18:07:51 -070040 u8 *outmsg; /* message to the userspace */
41 int outmsg_len; /* its length */
42 wait_queue_head_t outmsg_q; /* poll/read wait queue */
Vitaly Kuznetsova72f3a42015-12-14 19:01:54 -080043 struct mutex lock; /* protects struct members */
Vitaly Kuznetsova524bb52017-03-04 18:13:59 -070044 struct completion release; /* synchronize with fd release */
Vitaly Kuznetsov14b50f82015-04-11 18:07:51 -070045};
46
47struct hvutil_transport *hvutil_transport_init(const char *name,
48 u32 cn_idx, u32 cn_val,
49 int (*on_msg)(void *, int),
50 void (*on_reset)(void));
Vitaly Kuznetsove0fa3e52016-06-09 17:08:57 -070051int hvutil_transport_send(struct hvutil_transport *hvt, void *msg, int len,
52 void (*on_read_cb)(void));
Vitaly Kuznetsov14b50f82015-04-11 18:07:51 -070053void hvutil_transport_destroy(struct hvutil_transport *hvt);
54
55#endif /* _HV_UTILS_TRANSPORT_H */