2 Unix SMB/CIFS implementation.
3 Filename utility functions.
4 Copyright (C) Tim Prouty 2009
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
22 * XXX: This is temporary and there should be no callers of this outside of
23 * this file once smb_filename is plumbed through all path based operations.
24 * The one legitimate caller currently is smb_fname_str_dbg(), which this
25 * could be made static for.
27 NTSTATUS get_full_smb_filename(TALLOC_CTX *ctx,
28 const struct smb_filename *smb_fname,
31 if (smb_fname->stream_name) {
32 /* stream_name must always be NULL if there is no stream. */
33 SMB_ASSERT(smb_fname->stream_name[0] != '\0');
35 *full_name = talloc_asprintf(ctx, "%s%s", smb_fname->base_name,
36 smb_fname->stream_name);
38 *full_name = talloc_strdup(ctx, smb_fname->base_name);
42 return NT_STATUS_NO_MEMORY;
49 * There are actually legitimate callers of this such as functions that
50 * enumerate streams using the vfs_streaminfo interface and then want to
51 * operate on each stream.
53 NTSTATUS create_synthetic_smb_fname(TALLOC_CTX *ctx, const char *base_name,
54 const char *stream_name,
55 const SMB_STRUCT_STAT *psbuf,
56 struct smb_filename **smb_fname_out)
58 struct smb_filename smb_fname_loc;
60 ZERO_STRUCT(smb_fname_loc);
62 /* Setup the base_name/stream_name. */
63 smb_fname_loc.base_name = discard_const_p(char, base_name);
64 smb_fname_loc.stream_name = discard_const_p(char, stream_name);
66 /* Copy the psbuf if one was given. */
68 smb_fname_loc.st = *psbuf;
70 /* Let copy_smb_filename() do the heavy lifting. */
71 return copy_smb_filename(ctx, &smb_fname_loc, smb_fname_out);
75 * XXX: This is temporary and there should be no callers of this once
76 * smb_filename is plumbed through all path based operations.
78 NTSTATUS create_synthetic_smb_fname_split(TALLOC_CTX *ctx,
80 const SMB_STRUCT_STAT *psbuf,
81 struct smb_filename **smb_fname_out)
84 const char *stream_name = NULL;
85 char *base_name = NULL;
87 if (!lp_posix_pathnames()) {
88 stream_name = strchr_m(fname, ':');
91 /* Setup the base_name/stream_name. */
93 base_name = talloc_strndup(ctx, fname,
94 PTR_DIFF(stream_name, fname));
96 base_name = talloc_strdup(ctx, fname);
100 return NT_STATUS_NO_MEMORY;
103 status = create_synthetic_smb_fname(ctx, base_name, stream_name, psbuf,
105 TALLOC_FREE(base_name);
110 * Return a string using the talloc_tos()
112 const char *smb_fname_str_dbg(const struct smb_filename *smb_fname)
117 if (smb_fname == NULL) {
120 status = get_full_smb_filename(talloc_tos(), smb_fname, &fname);
121 if (!NT_STATUS_IS_OK(status)) {
128 * Return a debug string of the path name of an fsp using the talloc_tos().
130 const char *fsp_str_dbg(const struct files_struct *fsp)
132 return smb_fname_str_dbg(fsp->fsp_name);
136 * Create a debug string for the fnum of an fsp.
138 * This is allocated to talloc_tos() or a string constant
139 * in certain corner cases. The returned string should
140 * hence not be free'd directly but only via the talloc stack.
142 const char *fsp_fnum_dbg(const struct files_struct *fsp)
147 return "fnum [fsp is NULL]";
150 if (fsp->fnum == FNUM_FIELD_INVALID) {
151 return "fnum [invalid value]";
154 str = talloc_asprintf(talloc_tos(), "fnum %d", fsp->fnum);
156 DEBUG(1, ("%s: talloc_asprintf failed\n", __FUNCTION__));
157 return "fnum [talloc failed!]";
163 NTSTATUS copy_smb_filename(TALLOC_CTX *ctx,
164 const struct smb_filename *smb_fname_in,
165 struct smb_filename **smb_fname_out)
167 /* stream_name must always be NULL if there is no stream. */
168 if (smb_fname_in->stream_name) {
169 SMB_ASSERT(smb_fname_in->stream_name[0] != '\0');
172 *smb_fname_out = talloc_zero(ctx, struct smb_filename);
173 if (*smb_fname_out == NULL) {
174 return NT_STATUS_NO_MEMORY;
177 if (smb_fname_in->base_name) {
178 (*smb_fname_out)->base_name =
179 talloc_strdup(*smb_fname_out, smb_fname_in->base_name);
180 if (!(*smb_fname_out)->base_name)
184 if (smb_fname_in->stream_name) {
185 (*smb_fname_out)->stream_name =
186 talloc_strdup(*smb_fname_out, smb_fname_in->stream_name);
187 if (!(*smb_fname_out)->stream_name)
191 if (smb_fname_in->original_lcomp) {
192 (*smb_fname_out)->original_lcomp =
193 talloc_strdup(*smb_fname_out, smb_fname_in->original_lcomp);
194 if (!(*smb_fname_out)->original_lcomp)
198 (*smb_fname_out)->st = smb_fname_in->st;
202 TALLOC_FREE(*smb_fname_out);
203 return NT_STATUS_NO_MEMORY;
206 /****************************************************************************
207 Simple check to determine if the filename is a stream.
208 ***************************************************************************/
209 bool is_ntfs_stream_smb_fname(const struct smb_filename *smb_fname)
211 /* stream_name must always be NULL if there is no stream. */
212 if (smb_fname->stream_name) {
213 SMB_ASSERT(smb_fname->stream_name[0] != '\0');
216 if (lp_posix_pathnames()) {
220 return smb_fname->stream_name != NULL;
223 /****************************************************************************
224 Returns true if the filename's stream == "::$DATA"
225 ***************************************************************************/
226 bool is_ntfs_default_stream_smb_fname(const struct smb_filename *smb_fname)
228 if (!is_ntfs_stream_smb_fname(smb_fname)) {
232 return strcasecmp_m(smb_fname->stream_name, "::$DATA") == 0;