summaryrefslogtreecommitdiff
path: root/include/arch/x86_64/linux/nfsd/cld.h
blob: 70633f3d64ea3db202f553a65f40261b35b07401 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
/* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
/*
 * Upcall description for nfsdcld communication
 *
 * Copyright (c) 2012 Red Hat, Inc.
 * Author(s): Jeff Layton <jlayton@redhat.com>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#ifndef _NFSD_CLD_H
#define _NFSD_CLD_H

#include <linux/types.h>

/* latest upcall version available */
#define CLD_UPCALL_VERSION 2

/* defined by RFC3530 */
#define NFS4_OPAQUE_LIMIT 1024

#ifndef SHA256_DIGEST_SIZE
#define SHA256_DIGEST_SIZE 32
#endif

enum cld_command {
	Cld_Create,	/* create a record for this cm_id */
	Cld_Remove,	/* remove record of this cm_id */
	Cld_Check,	/* is this cm_id allowed? */
	Cld_GraceDone,	/* grace period is complete */
	Cld_GraceStart, /* grace start (upload client records) */
	Cld_GetVersion, /* query max supported upcall version */
};

/* representation of long-form NFSv4 client ID */
struct cld_name {
	__u16 cn_len;				/* length of cm_id */
	unsigned char cn_id[NFS4_OPAQUE_LIMIT]; /* client-provided */
} __attribute__((packed));

/* sha256 hash of the kerberos principal */
struct cld_princhash {
	__u8 cp_len;				   /* length of cp_data */
	unsigned char cp_data[SHA256_DIGEST_SIZE]; /* hash of principal */
} __attribute__((packed));

struct cld_clntinfo {
	struct cld_name cc_name;
	struct cld_princhash cc_princhash;
} __attribute__((packed));

/* message struct for communication with userspace */
struct cld_msg {
	__u8 cm_vers;	 /* upcall version */
	__u8 cm_cmd;	 /* upcall command */
	__s16 cm_status; /* return code */
	__u32 cm_xid;	 /* transaction id */
	union {
		__s64 cm_gracetime; /* grace period start time */
		struct cld_name cm_name;
		__u8 cm_version; /* for getting max version */
	} __attribute__((packed)) cm_u;
} __attribute__((packed));

/* version 2 message can include hash of kerberos principal */
struct cld_msg_v2 {
	__u8 cm_vers;	 /* upcall version */
	__u8 cm_cmd;	 /* upcall command */
	__s16 cm_status; /* return code */
	__u32 cm_xid;	 /* transaction id */
	union {
		struct cld_name cm_name;
		__u8 cm_version;		 /* for getting max version */
		struct cld_clntinfo cm_clntinfo; /* name & princ hash */
	} __attribute__((packed)) cm_u;
} __attribute__((packed));

struct cld_msg_hdr {
	__u8 cm_vers;	 /* upcall version */
	__u8 cm_cmd;	 /* upcall command */
	__s16 cm_status; /* return code */
	__u32 cm_xid;	 /* transaction id */
} __attribute__((packed));

#endif /* !_NFSD_CLD_H */