~zulcss/samba/server-dailies-3.4

VFS module functionality that is similar to Microsoft Shadow Copy services\&. When setup properly, this module allows Microsoft Shadow Copy clients to browse "shadow copies" on Samba shares\&.

185

.PP

186

This module is stackable\&.

187

.SH "CONFIGURATION"

188

.PP

189

\FCvfs_shadow_copy\F[]

190

relies on a filesystem snapshot implementation\&. Many common filesystems have native support for this\&.

191

.PP

192

Filesystem snapshots must be mounted on specially named directories in order to be recognized by

193

\FCvfs_shadow_copy\F[]\&. The snapshot mount points must be immediate children of a the directory being shared\&.

194

.PP

195

The snapshot naming convention is @GMT\-YYYY\&.MM\&.DD\-hh\&.mm\&.ss, where:

196

.sp

197

.RS 4

198

.ie n \{\

199

\h'-04'\(bu\h'+03'\c

200

.\}

201

.el \{\

202

.sp -1

203

.IP \(bu 2.3

204

.\}

205

\FCYYYY\F[]

206

is the 4 digit year

207

.RE

208

.sp

209

.RS 4

210

.ie n \{\

211

\h'-04'\(bu\h'+03'\c

212

.\}

213

.el \{\

214

.sp -1

215

.IP \(bu 2.3

216

.\}

217

\FCMM\F[]

218

is the 2 digit month

219

.RE

220

.sp

221

.RS 4

222

.ie n \{\

223

\h'-04'\(bu\h'+03'\c

224

.\}

225

.el \{\

226

.sp -1

227

.IP \(bu 2.3

228

.\}

229

\FCDD\F[]

230

is the 2 digit day

231

.RE

232

.sp

233

.RS 4

234

.ie n \{\

235

\h'-04'\(bu\h'+03'\c

236

.\}

237

.el \{\

238

.sp -1

239

.IP \(bu 2.3

240

.\}

241

\FChh\F[]

242

is the 2 digit hour

243

.RE

244

.sp

245

.RS 4

246

.ie n \{\

247

\h'-04'\(bu\h'+03'\c

248

.\}

249

.el \{\

250

.sp -1

251

.IP \(bu 2.3

252

.\}

253

\FCmm\F[]

254

is the 2 digit minute

255

.RE

256

.sp

257

.RS 4

258

.ie n \{\

259

\h'-04'\(bu\h'+03'\c

260

.\}

261

.el \{\

262

.sp -1

263

.IP \(bu 2.3

264

.\}

265

\FCss\F[]

266

is the 2 digit second\&.

267

.sp

268

.RE

269

.PP

270

The

271

\FCvfs_shadow_copy\F[]

272

snapshot naming convention can be produced with the following

273

\fBdate\fR(1)

274

command:

275

.sp

276

.if n \{\

277

.RS 4

278

.\}

279

.fam C

280

.ps -1

281

.nf

282

.if t \{\

283

.sp -1

284

.\}

285

.BB lightgray adjust-for-leading-newline

286

.sp -1

287

288

TZ=GMT date +@GMT\-%Y\&.%m\&.%d\-%H\&.%M\&.%S

289

290

.EB lightgray adjust-for-leading-newline

291

.if t \{\

292

.sp 1

293

.\}

294

.fi

295

.fam

296

.ps +1

297

.if n \{\

298

.RE

299

.\}

300

.SH "EXAMPLES"

301

.PP

302

Add shadow copy support to user home directories:

303

.sp

304

.if n \{\

305

.RS 4

306

.\}

307

.fam C

308

.ps -1

309

.nf

310

.if t \{\

311

.sp -1

312

.\}

313

.BB lightgray adjust-for-leading-newline

314

.sp -1

315

316

\fI[homes]\fR

317

\m[blue]\fBvfs objects = shadow_copy\fR\m[]

318

.EB lightgray adjust-for-leading-newline

319

.if t \{\

320

.sp 1

321

.\}

322

.fi

323

.fam

324

.ps +1

325

.if n \{\

326

.RE

327

.\}

328

.SH "CAVEATS"

329

.PP

330

This is not a backup, archival, or version control solution\&.

331

.PP

332

With Samba or Windows servers,

333

\FCvfs_shadow_copy\F[]

334

is designed to be an end\-user tool only\&. It does not replace or enhance your backup and archival solutions and should in no way be considered as such\&. Additionally, if you need version control, implement a version control system\&.

335

.SH "VERSION"

336

.PP

337

This man page is correct for version 3\&.0\&.25 of the Samba suite\&.

338

.SH "AUTHOR"

339

.PP

340

The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&.