~zulcss/samba/server-dailies-3.4

\FCsmbget\F[] [\-a,\ \-\-guest] [\-r,\ \-\-resume] [\-R,\ \-\-recursive] [\-u,\ \-\-username=STRING] [\-p,\ \-\-password=STRING] [\-w,\ \-\-workgroup=STRING] [\-n,\ \-\-nonprompt] [\-d,\ \-\-debuglevel=INT] [\-D,\ \-\-dots] [\-P,\ \-\-keep\-permissions] [\-o,\ \-\-outputfile] [\-f,\ \-\-rcfile] [\-q,\ \-\-quiet] [\-v,\ \-\-verbose] [\-b,\ \-\-blocksize] [\-?,\ \-\-help] [\-\-usage] {smb://host/share/path/to/file} [smb://url2/] [\&.\&.\&.]

175

.fam

176

.SH "DESCRIPTION"

177

.PP

178

This tool is part of the

179

\fBsamba\fR(7)

180

suite\&.

181

.PP

182

smbget is a simple utility with wget\-like semantics, that can download files from SMB servers\&. You can specify the files you would like to download on the command\-line\&.

183

.PP

184

The files should be in the smb\-URL standard, e\&.g\&. use smb://host/share/file for the UNC path

185

\fI\e\e\e\eHOST\e\eSHARE\e\efile\fR\&.

186

.SH "OPTIONS"

187

.PP

188

\-a, \-\-guest

189

.RS 4

190

Work as user guest

191

.RE

192

.PP

193

\-r, \-\-resume

194

.RS 4

195

Automatically resume aborted files

196

.RE

197

.PP

198

\-R, \-\-recursive

199

.RS 4

200

Recursively download files

201

.RE

202

.PP

203

\-u, \-\-username=STRING

204

.RS 4

205

Username to use

206

.RE

207

.PP

208

\-p, \-\-password=STRING

209

.RS 4

210

Password to use

211

.RE

212

.PP

213

\-w, \-\-workgroup=STRING

214

.RS 4

215

Workgroup to use (optional)

216

.RE

217

.PP

218

\-n, \-\-nonprompt

219

.RS 4

220

Don\'t ask anything (non\-interactive)

221

.RE

222

.PP

223

\-d, \-\-debuglevel=INT

224

.RS 4

225

Debuglevel to use

226

.RE

227

.PP

228

\-D, \-\-dots

229

.RS 4

230

Show dots as progress indication

231

.RE

232

.PP

233

\-P, \-\-keep\-permissions

234

.RS 4

235

Set same permissions on local file as are set on remote file\&.

236

.RE

237

.PP

238

\-o, \-\-outputfile

239

.RS 4

240

Write the file that is being download to the specified file\&. Can not be used together with \-R\&.

241

.RE

242

.PP

243

\-f, \-\-rcfile

244

.RS 4

245

Use specified rcfile\&. This will be loaded in the order it was specified \- e\&.g\&. if you specify any options before this one, they might get overriden by the contents of the rcfile\&.

246

.RE

247

.PP

248

\-q, \-\-quiet

249

.RS 4

250

Be quiet

251

.RE

252

.PP

253

\-v, \-\-verbose

254

.RS 4

255

Be verbose

256

.RE

257

.PP

258

\-b, \-\-blocksize

259

.RS 4

260

Number of bytes to download in a block\&. Defaults to 64000\&.

261

.RE

262

.PP

263

\-?, \-\-help

264

.RS 4

265

Show help message

266

.RE

267

.PP

268

\-\-usage

269

.RS 4

270

Display brief usage message

271

.RE

272

.SH "SMB URLS"

273

.PP

274

SMB URL\'s should be specified in the following format:

275

.PP

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

smb://[[[domain;]user[:password@]]server[/share[/path[/file]]]]

289

.EB lightgray adjust-for-leading-newline

290

.if t \{\

291

.sp 1

292

.\}

293

.fi

294

.fam

295

.ps +1

296

.if n \{\

297

.RE

298

.\}

299

.PP

300

.if n \{\

301

.RS 4

302

.\}

303

.fam C

304

.ps -1

305

.nf

306

.if t \{\

307

.sp -1

308

.\}

309

.BB lightgray adjust-for-leading-newline

310

.sp -1

311

312

smb:// means all the workgroups

313

.EB lightgray adjust-for-leading-newline

314

.if t \{\

315

.sp 1

316

.\}

317

.fi

318

.fam

319

.ps +1

320

.if n \{\

321

.RE

322

.\}

323

.PP

324

.if n \{\

325

.RS 4

326

.\}

327

.fam C

328

.ps -1

329

.nf

330

.if t \{\

331

.sp -1

332

.\}

333

.BB lightgray adjust-for-leading-newline

334

.sp -1

335

336

smb://name/ means, if \fIname\fR is a workgroup, all the servers in this workgroup, or if \fIname\fR is a server, all the shares on this server\&.

337

.EB lightgray adjust-for-leading-newline

338

.if t \{\

339

.sp 1

340

.\}

341

.fi

342

.fam

343

.ps +1

344

.if n \{\

345

.RE

346

.\}

347

.SH "EXAMPLES"

348

.sp

349

.if n \{\

350

.RS 4

351

.\}

352

.fam C

353

.ps -1

354

.nf

355

.if t \{\

356

.sp -1

357

.\}

358

.BB lightgray adjust-for-leading-newline

359

.sp -1

360

361

# Recursively download \'src\' directory

362

smbget \-R smb://rhonwyn/jelmer/src

363

# Download FreeBSD ISO and enable resuming

364

smbget \-r smb://rhonwyn/isos/FreeBSD5\&.1\&.iso

365

# Recursively download all ISOs

366

smbget \-Rr smb://rhonwyn/isos

367

# Backup my data on rhonwyn

368

smbget \-Rr smb://rhonwyn/

369

.EB lightgray adjust-for-leading-newline

370

.if t \{\

371

.sp 1

372

.\}

373

.fi

374

.fam

375

.ps +1

376

.if n \{\

377

.RE

378

.\}

379

.SH "BUGS"

380

.PP

381

Permission denied is returned in some cases where the cause of the error is unknown (such as an illegally formatted smb:// url or trying to get a directory without \-R turned on)\&.

382

.SH "VERSION"

383

.PP

384

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

385

.SH "AUTHOR"

386

.PP

387

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\&.

388

.PP

389

The smbget manpage was written by Jelmer Vernooij\&.