@@ -2401,6 +2401,171 @@ <h2 id="options-19"><a class="header" href="#options-19">Options</a></h2>
2401
2401
< p > Print version</ p >
2402
2402
</ dd >
2403
2403
</ dl >
2404
+ < h3 id ="operands "> < a class ="header " href ="#operands "> Operands</ a > </ h3 >
2405
+ < ul >
2406
+ < li >
2407
+ < p > Bs=BYTES : read and write up to BYTES bytes at a time (default: 512);
2408
+ overwrites ibs and obs.</ p >
2409
+ </ li >
2410
+ < li >
2411
+ < p > cbs=BYTES : the 'conversion block size' in bytes. Applies to the
2412
+ conv=block, and conv=unblock operations.</ p >
2413
+ </ li >
2414
+ < li >
2415
+ < p > conv=CONVS : a comma-separated list of conversion options or (for legacy
2416
+ reasons) file flags.</ p >
2417
+ </ li >
2418
+ < li >
2419
+ < p > count=N : stop reading input after N ibs-sized read operations rather
2420
+ than proceeding until EOF. See iflag=count_bytes if stopping after N bytes
2421
+ is preferred</ p >
2422
+ </ li >
2423
+ < li >
2424
+ < p > ibs=N : the size of buffer used for reads (default: 512)</ p >
2425
+ </ li >
2426
+ < li >
2427
+ < p > if=FILE : the file used for input. When not specified, stdin is used instead</ p >
2428
+ </ li >
2429
+ < li >
2430
+ < p > iflag=FLAGS : a comma-separated list of input flags which specify how the
2431
+ input source is treated. FLAGS may be any of the input-flags or general-flags
2432
+ specified below.</ p >
2433
+ </ li >
2434
+ < li >
2435
+ < p > skip=N (or iseek=N) : skip N ibs-sized records into input before beginning
2436
+ copy/convert operations. See iflag=seek_bytes if seeking N bytes is preferred.</ p >
2437
+ </ li >
2438
+ < li >
2439
+ < p > obs=N : the size of buffer used for writes (default: 512)</ p >
2440
+ </ li >
2441
+ < li >
2442
+ < p > of=FILE : the file used for output. When not specified, stdout is used
2443
+ instead</ p >
2444
+ </ li >
2445
+ < li >
2446
+ < p > oflag=FLAGS : comma separated list of output flags which specify how the
2447
+ output source is treated. FLAGS may be any of the output flags or general
2448
+ flags specified below</ p >
2449
+ </ li >
2450
+ < li >
2451
+ < p > seek=N (or oseek=N) : seeks N obs-sized records into output before
2452
+ beginning copy/convert operations. See oflag=seek_bytes if seeking N bytes is
2453
+ preferred</ p >
2454
+ </ li >
2455
+ < li >
2456
+ < p > status=LEVEL : controls whether volume and performance stats are written to
2457
+ stderr.</ p >
2458
+ < p > When unspecified, dd will print stats upon completion. An example is below.</ p >
2459
+ < p > plain
2460
+ 6+0 records in
2461
+ 16+0 records out
2462
+ 8192 bytes (8.2 kB, 8.0 KiB) copied, 0.00057009 s,
2463
+ 14.4 MB/s</ p >
2464
+ < p > The first two lines are the 'volume' stats and the final line is the
2465
+ 'performance' stats.
2466
+ The volume stats indicate the number of complete and partial ibs-sized reads,
2467
+ or obs-sized writes that took place during the copy. The format of the volume
2468
+ stats is < complete > +< partial > . If records have been truncated (see
2469
+ conv=block), the volume stats will contain the number of truncated records.</ p >
2470
+ < p > Possible LEVEL values are:</ p >
2471
+ < ul >
2472
+ < li > progress : Print periodic performance stats as the copy proceeds.</ li >
2473
+ < li > noxfer : Print final volume stats, but not performance stats.</ li >
2474
+ < li > none : Do not print any stats.</ li >
2475
+ </ ul >
2476
+ < p > Printing performance stats is also triggered by the INFO signal (where supported),
2477
+ or the USR1 signal. Setting the POSIXLY_CORRECT environment variable to any value
2478
+ (including an empty value) will cause the USR1 signal to be ignored.</ p >
2479
+ </ li >
2480
+ </ ul >
2481
+ < h3 id ="conversion-options "> < a class ="header " href ="#conversion-options "> Conversion Options</ a > </ h3 >
2482
+ < ul >
2483
+ < li >
2484
+ < p > ascii : convert from EBCDIC to ASCII. This is the inverse of the ebcdic
2485
+ option. Implies conv=unblock.</ p >
2486
+ </ li >
2487
+ < li >
2488
+ < p > ebcdic : convert from ASCII to EBCDIC. This is the inverse of the ascii
2489
+ option. Implies conv=block.</ p >
2490
+ </ li >
2491
+ < li >
2492
+ < p > ibm : convert from ASCII to EBCDIC, applying the conventions for [, ]
2493
+ and ~ specified in POSIX. Implies conv=block.</ p >
2494
+ </ li >
2495
+ < li >
2496
+ < p > ucase : convert from lower-case to upper-case.</ p >
2497
+ </ li >
2498
+ < li >
2499
+ < p > lcase : converts from upper-case to lower-case.</ p >
2500
+ </ li >
2501
+ < li >
2502
+ < p > block : for each newline less than the size indicated by cbs=BYTES, remove
2503
+ the newline and pad with spaces up to cbs. Lines longer than cbs are truncated.</ p >
2504
+ </ li >
2505
+ < li >
2506
+ < p > unblock : for each block of input of the size indicated by cbs=BYTES, remove
2507
+ right-trailing spaces and replace with a newline character.</ p >
2508
+ </ li >
2509
+ < li >
2510
+ < p > sparse : attempts to seek the output when an obs-sized block consists of
2511
+ only zeros.</ p >
2512
+ </ li >
2513
+ < li >
2514
+ < p > swab : swaps each adjacent pair of bytes. If an odd number of bytes is
2515
+ present, the final byte is omitted.</ p >
2516
+ </ li >
2517
+ < li >
2518
+ < p > sync : pad each ibs-sided block with zeros. If block or unblock is
2519
+ specified, pad with spaces instead.</ p >
2520
+ </ li >
2521
+ < li >
2522
+ < p > excl : the output file must be created. Fail if the output file is already
2523
+ present.</ p >
2524
+ </ li >
2525
+ < li >
2526
+ < p > nocreat : the output file will not be created. Fail if the output file in
2527
+ not already present.</ p >
2528
+ </ li >
2529
+ < li >
2530
+ < p > notrunc : the output file will not be truncated. If this option is not
2531
+ present, output will be truncated when opened.</ p >
2532
+ </ li >
2533
+ < li >
2534
+ < p > noerror : all read errors will be ignored. If this option is not present,
2535
+ dd will only ignore Error::Interrupted.</ p >
2536
+ </ li >
2537
+ < li >
2538
+ < p > fdatasync : data will be written before finishing.</ p >
2539
+ </ li >
2540
+ < li >
2541
+ < p > fsync : data and metadata will be written before finishing.</ p >
2542
+ </ li >
2543
+ </ ul >
2544
+ < h3 id ="input-flags "> < a class ="header " href ="#input-flags "> Input flags</ a > </ h3 >
2545
+ < ul >
2546
+ < li > count_bytes : a value to count=N will be interpreted as bytes.</ li >
2547
+ < li > skip_bytes : a value to skip=N will be interpreted as bytes.</ li >
2548
+ < li > fullblock : wait for ibs bytes from each read. zero-length reads are still
2549
+ considered EOF.</ li >
2550
+ </ ul >
2551
+ < h3 id ="output-flags "> < a class ="header " href ="#output-flags "> Output flags</ a > </ h3 >
2552
+ < ul >
2553
+ < li > append : open file in append mode. Consider setting conv=notrunc as well.</ li >
2554
+ < li > seek_bytes : a value to seek=N will be interpreted as bytes.</ li >
2555
+ </ ul >
2556
+ < h3 id ="general-flags "> < a class ="header " href ="#general-flags "> General Flags</ a > </ h3 >
2557
+ < ul >
2558
+ < li > Direct : use direct I/O for data.</ li >
2559
+ < li > directory : fail unless the given input (if used as an iflag) or
2560
+ output (if used as an oflag) is a directory.</ li >
2561
+ < li > dsync : use synchronized I/O for data.</ li >
2562
+ < li > sync : use synchronized I/O for data and metadata.</ li >
2563
+ < li > nonblock : use non-blocking I/O.</ li >
2564
+ < li > noatime : do not update access time.</ li >
2565
+ < li > nocache : request that OS drop cache.</ li >
2566
+ < li > noctty : do not assign a controlling tty.</ li >
2567
+ < li > nofollow : do not follow system links.</ li >
2568
+ </ ul >
2404
2569
< h2 id ="examples-18 "> < a class ="header " href ="#examples-18 "> Examples</ a > </ h2 >
2405
2570
< p > Make a bootable USB drive from an isohybrid file (such like < code > archlinux-xxx.iso</ code > ):</ p >
2406
2571
< pre > < code class ="language-shell "> dd if={{path/to/file.iso}} of=/dev/{{usb_drive}}
@@ -3911,8 +4076,8 @@ <h2 id="examples-35"><a class="header" href="#examples-35">Examples</a></h2>
3911
4076
</ div >
3912
4077
< pre > < code > id [OPTION]... [USER]...
3913
4078
</ code > </ pre >
3914
- < p > Print user and group information for each specified USER,
3915
- or (when USER omitted) for the current user.</ p >
4079
+ < p > Print user and group information for each specified < code > USER</ code > ,
4080
+ or (when < code > USER</ code > omitted) for the current user.</ p >
3916
4081
< h2 id ="options-38 "> < a class ="header " href ="#options-38 "> Options</ a > </ h2 >
3917
4082
< dl > < dt > < code > -A</ code > </ dt >
3918
4083
< dd >
@@ -3966,6 +4131,12 @@ <h2 id="options-38"><a class="header" href="#options-38">Options</a></h2>
3966
4131
< p > Print version</ p >
3967
4132
</ dd >
3968
4133
</ dl >
4134
+ < p > The id utility displays the user and group names and numeric IDs, of the
4135
+ calling process, to the standard output. If the real and effective IDs are
4136
+ different, both are displayed, otherwise only the real ID is displayed.</ p >
4137
+ < p > If a user (login name or user ID) is specified, the user and group IDs of
4138
+ that user are displayed. In this case, the real and effective IDs are
4139
+ assumed to be the same.</ p >
3969
4140
< h2 id ="examples-36 "> < a class ="header " href ="#examples-36 "> Examples</ a > </ h2 >
3970
4141
< p > Display current user's ID (UID), group ID (GID) and groups to which they belong:</ p >
3971
4142
< pre > < code class ="language-shell "> id
@@ -4118,7 +4289,7 @@ <h2 id="examples-37"><a class="header" href="#examples-37">Examples</a></h2>
4118
4289
</ code > </ pre >
4119
4290
< p > For each pair of input lines with identical join fields, write a line to
4120
4291
standard output. The default join field is the first, delimited by blanks.</ p >
4121
- < p > When FILE1 or FILE2 (not both) is - , read standard input.</ p >
4292
+ < p > When < code > FILE1</ code > or < code > FILE2</ code > (not both) is < code > - </ code > , read standard input.</ p >
4122
4293
< h2 id ="options-40 "> < a class ="header " href ="#options-40 "> Options</ a > </ h2 >
4123
4294
< dl > < dt > < code > -a <FILENUM></ code > </ dt >
4124
4295
< dd >
@@ -5107,7 +5278,7 @@ <h2 id="examples-49"><a class="header" href="#examples-49">Examples</a></h2>
5107
5278
mv [OPTION]... SOURCE... DIRECTORY
5108
5279
mv [OPTION]... -t DIRECTORY SOURCE...
5109
5280
</ code > </ pre >
5110
- < p > Move SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY.</ p >
5281
+ < p > Move < code > SOURCE</ code > to < code > DEST</ code > , or multiple < code > SOURCE</ code > (s) to < code > DIRECTORY</ code > .</ p >
5111
5282
< h2 id ="options-52 "> < a class ="header " href ="#options-52 "> Options</ a > </ h2 >
5112
5283
< dl > < dt > < code > --backup=<CONTROL></ code > </ dt >
5113
5284
< dd >
@@ -5382,7 +5553,7 @@ <h2 id="examples-53"><a class="header" href="#examples-53">Examples</a></h2>
5382
5553
< pre > < code > nproc [OPTIONS]...
5383
5554
</ code > </ pre >
5384
5555
< p > Print the number of cores available to the current process.
5385
- If the OMP_NUM_THREADS or OMP_THREAD_LIMIT environment variables are set, then
5556
+ If the < code > OMP_NUM_THREADS</ code > or < code > OMP_THREAD_LIMIT</ code > environment variables are set, then
5386
5557
they will determine the minimum and maximum returned value respectively.</ p >
5387
5558
< h2 id ="options-56 "> < a class ="header " href ="#options-56 "> Options</ a > </ h2 >
5388
5559
< dl > < dt > < code > --all</ code > </ dt >
@@ -8942,7 +9113,7 @@ <h2 id="examples-90"><a class="header" href="#examples-90">Examples</a></h2>
8942
9113
</ div >
8943
9114
< pre > < code > touch [OPTION]... [USER]
8944
9115
</ code > </ pre >
8945
- < p > Update the access and modification times of each FILE to the current time.</ p >
9116
+ < p > Update the access and modification times of each < code > FILE</ code > to the current time.</ p >
8946
9117
< h2 id ="options-101 "> < a class ="header " href ="#options-101 "> Options</ a > </ h2 >
8947
9118
< dl > < dt > < code > --help</ code > </ dt >
8948
9119
< dd >
0 commit comments