1/* SPDX-License-Identifier: GPL-2.0 */
 2/*
 3 * DFS referral cache routines
 4 *
 5 * Copyright (c) 2018-2019 Paulo Alcantara <palcantara@suse.de>
 6 */
 7
 8#ifndef _CIFS_DFS_CACHE_H
 9#define _CIFS_DFS_CACHE_H
10
11#include <linux/nls.h>
12#include <linux/list.h>
13#include <linux/uuid.h>
14#include "cifsglob.h"
15
16#define DFS_CACHE_TGT_LIST_INIT(var) { .tl_numtgts = 0, .tl_list = LIST_HEAD_INIT((var).tl_list), }
17
18struct dfs_cache_tgt_list {
19	int tl_numtgts;
20	struct list_head tl_list;
21};
22
23struct dfs_cache_tgt_iterator {
24	char *it_name;
25	int it_path_consumed;
26	struct list_head it_list;
27};
28
29int dfs_cache_init(void);
30void dfs_cache_destroy(void);
31extern const struct proc_ops dfscache_proc_ops;
32
33int dfs_cache_find(const unsigned int xid, struct cifs_ses *ses, const struct nls_table *cp,
34		   int remap, const char *path, struct dfs_info3_param *ref,
35		   struct dfs_cache_tgt_list *tgt_list);
36int dfs_cache_noreq_find(const char *path, struct dfs_info3_param *ref,
37			 struct dfs_cache_tgt_list *tgt_list);
38void dfs_cache_noreq_update_tgthint(const char *path, const struct dfs_cache_tgt_iterator *it);
39int dfs_cache_get_tgt_referral(const char *path, const struct dfs_cache_tgt_iterator *it,
40			       struct dfs_info3_param *ref);
41int dfs_cache_get_tgt_share(char *path, const struct dfs_cache_tgt_iterator *it, char **share,
42			    char **prefix);
43void dfs_cache_put_refsrv_sessions(const uuid_t *mount_id);
44void dfs_cache_add_refsrv_session(const uuid_t *mount_id, struct cifs_ses *ses);
45char *dfs_cache_canonical_path(const char *path, const struct nls_table *cp, int remap);
46int dfs_cache_remount_fs(struct cifs_sb_info *cifs_sb);
47
48static inline struct dfs_cache_tgt_iterator *
49dfs_cache_get_next_tgt(struct dfs_cache_tgt_list *tl,
50		       struct dfs_cache_tgt_iterator *it)
51{
52	if (!tl || list_empty(&tl->tl_list) || !it ||
53	    list_is_last(&it->it_list, &tl->tl_list))
54		return NULL;
55	return list_next_entry(it, it_list);
56}
57
58static inline struct dfs_cache_tgt_iterator *
59dfs_cache_get_tgt_iterator(struct dfs_cache_tgt_list *tl)
60{
61	if (!tl)
62		return NULL;
63	return list_first_entry_or_null(&tl->tl_list,
64					struct dfs_cache_tgt_iterator,
65					it_list);
66}
67
68static inline void dfs_cache_free_tgts(struct dfs_cache_tgt_list *tl)
69{
70	struct dfs_cache_tgt_iterator *it, *nit;
71
72	if (!tl || list_empty(&tl->tl_list))
73		return;
74	list_for_each_entry_safe(it, nit, &tl->tl_list, it_list) {
75		list_del(&it->it_list);
76		kfree(it->it_name);
77		kfree(it);
78	}
79	tl->tl_numtgts = 0;
80}
81
82static inline const char *
83dfs_cache_get_tgt_name(const struct dfs_cache_tgt_iterator *it)
84{
85	return it ? it->it_name : NULL;
86}
87
88static inline int
89dfs_cache_get_nr_tgts(const struct dfs_cache_tgt_list *tl)
90{
91	return tl ? tl->tl_numtgts : 0;
92}
93
94#endif /* _CIFS_DFS_CACHE_H */