~zulcss/samba/server-dailies-3.4

\FCsmbcquotas\F[] {//server/share} [\-u\ user] [\-L] [\-F] [\-S\ QUOTA_SET_COMMAND] [\-n] [\-t] [\-v] [\-d\ debuglevel] [\-s\ configfile] [\-l\ logdir] [\-V] [\-U\ username] [\-N] [\-k] [\-A]

175

.fam

176

.SH "DESCRIPTION"

177

.PP

178

This tool is part of the

179

\fBsamba\fR(7)

180

suite\&.

181

.PP

182

The

183

\FCsmbcquotas\F[]

184

program manipulates NT Quotas on SMB file shares\&.

185

.SH "OPTIONS"

186

.PP

187

The following options are available to the

188

\FCsmbcquotas\F[]

189

program\&.

190

.PP

191

\-u user

192

.RS 4

193

Specifies the user of whom the quotas are get or set\&. By default the current user\'s username will be used\&.

194

.RE

195

.PP

196

\-L

197

.RS 4

198

Lists all quota records of the share\&.

199

.RE

200

.PP

201

\-F

202

.RS 4

203

Show the share quota status and default limits\&.

204

.RE

205

.PP

206

\-S QUOTA_SET_COMMAND

207

.RS 4

208

This command sets/modifies quotas for a user or on the share, depending on the QUOTA_SET_COMMAND parameter which is described later\&.

209

.RE

210

.PP

211

\-n

212

.RS 4

213

This option displays all QUOTA information in numeric format\&. The default is to convert SIDs to names and QUOTA limits to a readable string format\&.

214

.RE

215

.PP

216

\-t

217

.RS 4

218

Don\'t actually do anything, only validate the correctness of the arguments\&.

219

.RE

220

.PP

221

\-v

222

.RS 4

223

Be verbose\&.

224

.RE

225

.PP

226

\-h|\-\-help

227

.RS 4

228

Print a summary of command line options\&.

229

.RE

230

.PP

231

\-d|\-\-debuglevel=level

232

.RS 4

233

\fIlevel\fR

234

is an integer from 0 to 10\&. The default value if this parameter is not specified is 0\&.

235

.sp

236

The higher this value, the more detail will be logged to the log files about the activities of the server\&. At level 0, only critical errors and serious warnings will be logged\&. Level 1 is a reasonable level for day\-to\-day running \- it generates a small amount of information about operations carried out\&.

237

.sp

238

Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem\&. Levels above 3 are designed for use only by developers and generate HUGE amounts of log data, most of which is extremely cryptic\&.

239

.sp

240

Note that specifying this parameter here will override the

241

\m[blue]\fB\%smb.conf.5.html#\fR\m[]

242

parameter in the

243

\FCsmb\&.conf\F[]

244

file\&.

245

.RE

246

.PP

247

\-V|\-\-version

248

.RS 4

249

Prints the program version number\&.

250

.RE

251

.PP

252

\-s|\-\-configfile <configuration file>

253

.RS 4

254

The file specified contains the configuration details required by the server\&. The information in this file includes server\-specific information such as what printcap file to use, as well as descriptions of all the services that the server is to provide\&. See

255

\FCsmb\&.conf\F[]

256

for more information\&. The default configuration file name is determined at compile time\&.

257

.RE

258

.PP

259

\-l|\-\-log\-basename=logdirectory

260

.RS 4

261

Base directory name for log/debug files\&. The extension

262

\fB"\&.progname"\fR

263

will be appended (e\&.g\&. log\&.smbclient, log\&.smbd, etc\&.\&.\&.)\&. The log file is never removed by the client\&.

264

.RE

265

.PP

266

\-N|\-\-no\-pass

267

.RS 4

268

If specified, this parameter suppresses the normal password prompt from the client to the user\&. This is useful when accessing a service that does not require a password\&.

269

.sp

270

Unless a password is specified on the command line or this parameter is specified, the client will request a password\&.

271

.sp

272

If a password is specified on the command line and this option is also defined the password on the command line will be silently ingnored and no password will be used\&.

273

.RE

274

.PP

275

\-k|\-\-kerberos

276

.RS 4

277

Try to authenticate with kerberos\&. Only useful in an Active Directory environment\&.

278

.RE

279

.PP

280

\-C|\-\-use\-ccache

281

.RS 4

282

Try to use the credentials cached by winbind\&.

283

.RE

284

.PP

285

\-A|\-\-authentication\-file=filename

286

.RS 4

287

This option allows you to specify a file from which to read the username and password used in the connection\&. The format of the file is

288

.sp

289

.if n \{\

290

.RS 4

291

.\}

292

.fam C

293

.ps -1

294

.nf

295

.if t \{\

296

.sp -1

297

.\}

298

.BB lightgray adjust-for-leading-newline

299

.sp -1

300

301

username = <value>

302

password = <value>

303

domain = <value>

304

.EB lightgray adjust-for-leading-newline

305

.if t \{\

306

.sp 1

307

.\}

308

.fi

309

.fam

310

.ps +1

311

.if n \{\

312

.RE

313

.\}

314

.sp

315

Make certain that the permissions on the file restrict access from unwanted users\&.

316

.RE

317

.PP

318

\-U|\-\-user=username[%password]

319

.RS 4

320

Sets the SMB username or username and password\&.

321

.sp

322

If %password is not specified, the user will be prompted\&. The client will first check the

323

\fBUSER\fR

324

environment variable, then the

325

\fBLOGNAME\fR

326

variable and if either exists, the string is uppercased\&. If these environmental variables are not found, the username

327

\fBGUEST\fR

328

is used\&.

329

.sp

330

A third option is to use a credentials file which contains the plaintext of the username and password\&. This option is mainly provided for scripts where the admin does not wish to pass the credentials on the command line or via environment variables\&. If this method is used, make certain that the permissions on the file restrict access from unwanted users\&. See the

331

\fI\-A\fR

332

for more details\&.

333

.sp

334

Be cautious about including passwords in scripts\&. Also, on many systems the command line of a running process may be seen via the

335

\FCps\F[]

336

command\&. To be safe always allow

337

\FCrpcclient\F[]

338

to prompt for a password and type it in directly\&.

339

.RE

340

.SH "QUOTA_SET_COMAND"

341

.PP

342

The format of an the QUOTA_SET_COMMAND is an operation name followed by a set of parameters specific to that operation\&.

343

.PP

344

To set user quotas for the user specified by \-u or for the current username:

345

.PP

346

\fB UQLIM:<username>:<softlimit>/<hardlimit> \fR

347

.PP

348

To set the default quotas for a share:

349

.PP

350

\fB FSQLIM:<softlimit>/<hardlimit> \fR

351

.PP

352

To change the share quota settings:

353

.PP

354

\fB FSQFLAGS:QUOTA_ENABLED/DENY_DISK/LOG_SOFTLIMIT/LOG_HARD_LIMIT \fR

355

.PP

356

All limits are specified as a number of bytes\&.

357

.SH "EXIT STATUS"

358

.PP

359

The

360

\FCsmbcquotas\F[]

361

program sets the exit status depending on the success or otherwise of the operations performed\&. The exit status may be one of the following values\&.

362

.PP

363

If the operation succeeded, smbcquotas returns an exit status of 0\&. If

364

\FCsmbcquotas\F[]

365

couldn\'t connect to the specified server, or when there was an error getting or setting the quota(s), an exit status of 1 is returned\&. If there was an error parsing any command line arguments, an exit status of 2 is returned\&.

366

.SH "VERSION"

367

.PP

368

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

369

.SH "AUTHOR"

370

.PP

371

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

372

.PP

373

\FCsmbcquotas\F[]

374

was written by Stefan Metzmacher\&.