typescript-virtual-container 1.4.7 → 1.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/README.md +0 -1
  2. package/benchmark-results.txt +21 -21
  3. package/builds/self-standalone.js +979 -167
  4. package/builds/self-standalone.js.map +4 -4
  5. package/builds/standalone-wo-sftp.js +982 -172
  6. package/builds/standalone-wo-sftp.js.map +4 -4
  7. package/builds/standalone.cjs +990 -179
  8. package/builds/standalone.cjs.map +4 -4
  9. package/dist/SSHMimic/index.d.ts.map +1 -1
  10. package/dist/SSHMimic/index.js +2 -0
  11. package/dist/SSHMimic/index.js.map +1 -1
  12. package/dist/VirtualFileSystem/binaryPack.d.ts.map +1 -1
  13. package/dist/VirtualFileSystem/binaryPack.js +21 -9
  14. package/dist/VirtualFileSystem/binaryPack.js.map +1 -1
  15. package/dist/VirtualFileSystem/index.d.ts +25 -0
  16. package/dist/VirtualFileSystem/index.d.ts.map +1 -1
  17. package/dist/VirtualFileSystem/index.js +152 -47
  18. package/dist/VirtualFileSystem/index.js.map +1 -1
  19. package/dist/VirtualFileSystem/internalTypes.d.ts +19 -4
  20. package/dist/VirtualFileSystem/internalTypes.d.ts.map +1 -1
  21. package/dist/VirtualFileSystem/path.js +1 -1
  22. package/dist/VirtualFileSystem/path.js.map +1 -1
  23. package/dist/VirtualShell/idleManager.d.ts +65 -0
  24. package/dist/VirtualShell/idleManager.d.ts.map +1 -0
  25. package/dist/VirtualShell/idleManager.js +106 -0
  26. package/dist/VirtualShell/idleManager.js.map +1 -0
  27. package/dist/VirtualShell/index.d.ts +28 -0
  28. package/dist/VirtualShell/index.d.ts.map +1 -1
  29. package/dist/VirtualShell/index.js +48 -0
  30. package/dist/VirtualShell/index.js.map +1 -1
  31. package/dist/commands/man.d.ts.map +1 -1
  32. package/dist/commands/man.js +5 -28
  33. package/dist/commands/man.js.map +1 -1
  34. package/dist/commands/manuals-bundle.d.ts +11 -0
  35. package/dist/commands/manuals-bundle.d.ts.map +1 -0
  36. package/dist/commands/manuals-bundle.js +898 -0
  37. package/dist/commands/manuals-bundle.js.map +1 -0
  38. package/dist/index.d.ts +2 -0
  39. package/dist/index.d.ts.map +1 -1
  40. package/dist/index.js +1 -0
  41. package/dist/index.js.map +1 -1
  42. package/dist/modules/linuxRootfs.d.ts +8 -1
  43. package/dist/modules/linuxRootfs.d.ts.map +1 -1
  44. package/dist/modules/linuxRootfs.js +47 -14
  45. package/dist/modules/linuxRootfs.js.map +1 -1
  46. package/dist/self-standalone.js +15 -0
  47. package/dist/self-standalone.js.map +1 -1
  48. package/dist/standalone.js +22 -0
  49. package/dist/standalone.js.map +1 -1
  50. package/docs/assets/hierarchy.js +1 -1
  51. package/docs/assets/navigation.js +1 -1
  52. package/docs/assets/search.js +1 -1
  53. package/docs/classes/HoneyPot.html +8 -8
  54. package/docs/classes/IdleManager.html +159 -0
  55. package/docs/classes/SshClient.html +18 -18
  56. package/docs/classes/VirtualFileSystem.html +57 -32
  57. package/docs/classes/VirtualPackageManager.html +12 -12
  58. package/docs/classes/VirtualSftpServer.html +3 -3
  59. package/docs/classes/VirtualShell.html +40 -25
  60. package/docs/classes/VirtualSshServer.html +5 -5
  61. package/docs/classes/VirtualUserManager.html +26 -26
  62. package/docs/functions/assertDiff.html +1 -1
  63. package/docs/functions/diffSnapshots.html +1 -1
  64. package/docs/functions/formatDiff.html +1 -1
  65. package/docs/functions/getArg.html +1 -1
  66. package/docs/functions/getFlag.html +1 -1
  67. package/docs/functions/ifFlag.html +1 -1
  68. package/docs/hierarchy.html +1 -1
  69. package/docs/index.html +1 -2
  70. package/docs/interfaces/AuditLogEntry.html +2 -2
  71. package/docs/interfaces/CommandContext.html +11 -11
  72. package/docs/interfaces/CommandResult.html +12 -12
  73. package/docs/interfaces/ExecStream.html +5 -5
  74. package/docs/interfaces/HoneyPotStats.html +2 -2
  75. package/docs/interfaces/IdleManagerOptions.html +7 -0
  76. package/docs/interfaces/InstalledPackage.html +10 -10
  77. package/docs/interfaces/NanoEditorSession.html +4 -4
  78. package/docs/interfaces/PackageDefinition.html +13 -13
  79. package/docs/interfaces/PackageFile.html +4 -4
  80. package/docs/interfaces/RemoveOptions.html +2 -2
  81. package/docs/interfaces/ShellEnv.html +3 -3
  82. package/docs/interfaces/ShellModule.html +7 -7
  83. package/docs/interfaces/ShellProperties.html +4 -4
  84. package/docs/interfaces/ShellStream.html +6 -6
  85. package/docs/interfaces/SudoChallenge.html +8 -8
  86. package/docs/interfaces/VfsBaseNode.html +6 -6
  87. package/docs/interfaces/VfsDiff.html +5 -5
  88. package/docs/interfaces/VfsDiffEntry.html +3 -3
  89. package/docs/interfaces/VfsDiffModified.html +5 -5
  90. package/docs/interfaces/VfsDirectoryNode.html +7 -7
  91. package/docs/interfaces/VfsFileNode.html +8 -8
  92. package/docs/interfaces/VfsOptions.html +18 -4
  93. package/docs/interfaces/VfsSnapshot.html +2 -2
  94. package/docs/interfaces/VfsSnapshotBaseNode.html +3 -3
  95. package/docs/interfaces/VfsSnapshotDirectoryNode.html +4 -4
  96. package/docs/interfaces/VfsSnapshotFileNode.html +5 -5
  97. package/docs/interfaces/WriteFileOptions.html +3 -3
  98. package/docs/modules.html +1 -1
  99. package/docs/types/CommandMode.html +1 -1
  100. package/docs/types/CommandOutcome.html +1 -1
  101. package/docs/types/IdleState.html +1 -0
  102. package/docs/types/VfsNodeStats.html +1 -1
  103. package/docs/types/VfsNodeType.html +1 -1
  104. package/docs/types/VfsPersistenceMode.html +1 -1
  105. package/docs/types/VfsSnapshotNode.html +1 -1
  106. package/package.json +5 -4
  107. package/scripts/generate-manuals-bundle.mjs +49 -0
  108. package/src/SSHMimic/index.ts +2 -0
  109. package/src/VirtualFileSystem/binaryPack.ts +21 -9
  110. package/src/VirtualFileSystem/index.ts +151 -53
  111. package/src/VirtualFileSystem/internalTypes.ts +20 -4
  112. package/src/VirtualFileSystem/path.ts +1 -1
  113. package/src/VirtualShell/idleManager.ts +133 -0
  114. package/src/VirtualShell/index.ts +48 -0
  115. package/src/commands/man.ts +5 -37
  116. package/src/commands/manuals-bundle.ts +898 -0
  117. package/src/index.ts +2 -0
  118. package/src/modules/linuxRootfs.ts +58 -14
  119. package/src/self-standalone.ts +13 -0
  120. package/src/standalone.ts +23 -0
@@ -0,0 +1,898 @@
1
+ /**
2
+ * Auto-generated by scripts/generate-manuals-bundle.mjs
3
+ * DO NOT EDIT — run `node scripts/generate-manuals-bundle.mjs` to regenerate.
4
+ *
5
+ * Inlines all src/commands/manuals/*.txt files so that standalone and web
6
+ * builds have access to man pages without needing filesystem access.
7
+ */
8
+ /** biome-ignore-all lint/style/useNamingConvention: generated keys match command names (e.g. lsb_release) */
9
+
10
+ /** Static map of command name → man page content. */
11
+ export const MANUALS: Readonly<Record<string, string>> = {
12
+ "adduser": `ADDUSER(8) User Commands ADDUSER(8)
13
+
14
+ NAME
15
+ adduser - add a user to the system
16
+
17
+ SYNOPSIS
18
+ adduser USERNAME
19
+
20
+ DESCRIPTION
21
+ Create a new user account with a home directory.
22
+ In this environment, prompts for a password interactively.`,
23
+ "apt-cache": `APT-CACHE(8) APT APT-CACHE(8)
24
+
25
+ NAME
26
+ apt-cache - query APT package cache
27
+
28
+ SYNOPSIS
29
+ apt-cache command [args]
30
+
31
+ COMMANDS
32
+ search term search package names/descriptions
33
+ show pkg show package metadata
34
+ policy pkg show package policy and candidate versions`,
35
+ "apt": `APT(8) APT APT(8)
36
+
37
+ NAME
38
+ apt - command-line interface
39
+
40
+ SYNOPSIS
41
+ apt [options] command
42
+
43
+ DESCRIPTION
44
+ apt provides a high-level commandline interface for the package
45
+ management system.
46
+
47
+ COMMANDS
48
+ install pkg... Install packages
49
+ remove pkg... Remove packages
50
+ update Download package information
51
+ upgrade Upgrade installed packages
52
+ search term Search in package descriptions
53
+ show pkg Show package information
54
+ list List packages`,
55
+ "awk": `AWK(1) User Commands AWK(1)
56
+
57
+ NAME
58
+ awk - pattern scanning and processing language
59
+
60
+ SYNOPSIS
61
+ awk [OPTION]... 'PROGRAM' [FILE]...
62
+
63
+ DESCRIPTION
64
+ awk scans each input line, applies PROGRAM rules, and prints results.
65
+
66
+ OPTIONS
67
+ -F fs use fs as input field separator`,
68
+ "cat": `CAT(1) User Commands CAT(1)
69
+
70
+ NAME
71
+ cat - concatenate files and print on the standard output
72
+
73
+ SYNOPSIS
74
+ cat [OPTION]... [FILE]...
75
+
76
+ DESCRIPTION
77
+ Concatenate FILE(s) to standard output.
78
+
79
+ OPTIONS
80
+ -n, --number number all output lines
81
+ -b, --number-nonblank number nonempty output lines`,
82
+ "cd": `CD(1) Shell Builtins CD(1)
83
+
84
+ NAME
85
+ cd - change the shell working directory
86
+
87
+ SYNOPSIS
88
+ cd [DIRECTORY]
89
+
90
+ DESCRIPTION
91
+ Change the current working directory.
92
+ Without DIRECTORY, changes to $HOME.
93
+
94
+ EXAMPLES
95
+ cd /etc
96
+ cd ..
97
+ cd ~`,
98
+ "chmod": `CHMOD(1) User Commands CHMOD(1)
99
+
100
+ NAME
101
+ chmod - change file mode bits
102
+
103
+ SYNOPSIS
104
+ chmod [OPTION]... MODE[,MODE]... FILE...
105
+ chmod [OPTION]... OCTAL-MODE FILE...
106
+
107
+ DESCRIPTION
108
+ Change the file mode bits of each given file according to MODE.
109
+
110
+ EXAMPLES
111
+ chmod 755 script.sh rwxr-xr-x
112
+ chmod 644 file.txt rw-r--r--
113
+ chmod +x script.sh add execute permission`,
114
+ "clear": `CLEAR(1) User Commands CLEAR(1)
115
+
116
+ NAME
117
+ clear - clear the terminal screen
118
+
119
+ SYNOPSIS
120
+ clear
121
+
122
+ DESCRIPTION
123
+ Clear the display and move cursor to top-left.`,
124
+ "cp": `CP(1) User Commands CP(1)
125
+
126
+ NAME
127
+ cp - copy files and directories
128
+
129
+ SYNOPSIS
130
+ cp [OPTION]... SOURCE... DEST
131
+
132
+ OPTIONS
133
+ -r copy directories recursively`,
134
+ "curl": `CURL(1) User Commands CURL(1)
135
+
136
+ NAME
137
+ curl - transfer a URL
138
+
139
+ SYNOPSIS
140
+ curl [options / URLs]
141
+
142
+ DESCRIPTION
143
+ curl is a tool for transferring data with URL syntax.
144
+
145
+ OPTIONS
146
+ -o, --output <file> Write output to <file>
147
+ -X, --request <method> Specify request method
148
+ -d, --data <data> HTTP POST data
149
+ -H, --header <header> Pass custom header
150
+ -s, --silent Silent mode
151
+ -I, --head Show document info only
152
+ -L, --location Follow redirects
153
+ -v, --verbose Make the operation more talkative`,
154
+ "date": `DATE(1) User Commands DATE(1)
155
+
156
+ NAME
157
+ date - print or set the system date and time
158
+
159
+ SYNOPSIS
160
+ date [+FORMAT]
161
+
162
+ DESCRIPTION
163
+ Display current date/time, optionally formatted.
164
+
165
+ EXAMPLES
166
+ date
167
+ date +%Y-%m-%d`,
168
+ "declare": `DECLARE(1) Shell Builtins DECLARE(1)
169
+
170
+ NAME
171
+ declare - set variable values and attributes
172
+
173
+ SYNOPSIS
174
+ declare [OPTION]... [NAME[=VALUE]...]
175
+
176
+ OPTIONS
177
+ -i variable has integer attribute
178
+ -r make NAMEs readonly
179
+ -x export NAMEs to environment`,
180
+ "deluser": `DELUSER(8) User Commands DELUSER(8)
181
+
182
+ NAME
183
+ deluser - remove a user account
184
+
185
+ SYNOPSIS
186
+ deluser [OPTION] USERNAME
187
+
188
+ OPTIONS
189
+ -f, --force remove without interactive confirmation`,
190
+ "df": `DF(1) User Commands DF(1)
191
+
192
+ NAME
193
+ df - report file system disk space usage
194
+
195
+ SYNOPSIS
196
+ df [OPTION]... [FILE]...
197
+
198
+ OPTIONS
199
+ -h print sizes in human readable format`,
200
+ "dpkg-query": `DPKG-QUERY(1) User Commands DPKG-QUERY(1)
201
+
202
+ NAME
203
+ dpkg-query - tool to query the dpkg database
204
+
205
+ SYNOPSIS
206
+ dpkg-query [OPTION]... [ACTION]
207
+
208
+ OPTIONS
209
+ -W list installed packages (show format)
210
+ -l list packages`,
211
+ "dpkg": `DPKG(1) User Commands DPKG(1)
212
+
213
+ NAME
214
+ dpkg - package manager for Debian-like systems
215
+
216
+ SYNOPSIS
217
+ dpkg [OPTION]... ACTION
218
+
219
+ OPTIONS
220
+ -l list installed packages
221
+ -s show package status
222
+ -L list files in package
223
+ -r remove package
224
+ -P purge package`,
225
+ "du": `DU(1) User Commands DU(1)
226
+
227
+ NAME
228
+ du - estimate file space usage
229
+
230
+ SYNOPSIS
231
+ du [OPTION]... [FILE]...
232
+
233
+ OPTIONS
234
+ -h print sizes in human readable format
235
+ -s display only a total for each argument`,
236
+ "echo": `ECHO(1) User Commands ECHO(1)
237
+
238
+ NAME
239
+ echo - display a line of text
240
+
241
+ SYNOPSIS
242
+ echo [OPTION]... [STRING]...
243
+
244
+ OPTIONS
245
+ -n do not output the trailing newline
246
+ -e enable interpretation of backslash escapes`,
247
+ "false": `FALSE(1) User Commands FALSE(1)
248
+
249
+ NAME
250
+ false - do nothing, unsuccessfully
251
+
252
+ SYNOPSIS
253
+ false
254
+
255
+ DESCRIPTION
256
+ Exit with a status code indicating failure (1).`,
257
+ "find": `FIND(1) User Commands FIND(1)
258
+
259
+ NAME
260
+ find - search for files in a directory hierarchy
261
+
262
+ SYNOPSIS
263
+ find [PATH] [EXPRESSION]
264
+
265
+ OPTIONS
266
+ -name PATTERN base name matches shell PATTERN
267
+ -type TYPE file type, e.g. f for file, d for directory`,
268
+ "free": `FREE(1) User Commands FREE(1)
269
+
270
+ NAME
271
+ free - display amount of free and used memory in the system
272
+
273
+ SYNOPSIS
274
+ free [OPTION]...
275
+
276
+ OPTIONS
277
+ -h show all output fields automatically scaled
278
+ -m show output in mebibytes
279
+ -g show output in gibibytes`,
280
+ "grep": `GREP(1) User Commands GREP(1)
281
+
282
+ NAME
283
+ grep, egrep, fgrep - print lines that match patterns
284
+
285
+ SYNOPSIS
286
+ grep [OPTION]... PATTERNS [FILE]...
287
+
288
+ OPTIONS
289
+ -i, --ignore-case ignore case distinctions in patterns and data
290
+ -v, --invert-match select non-matching lines
291
+ -n, --line-number print line number with output lines
292
+ -r, --recursive read all files under each directory, recursively`,
293
+ "groups": `GROUPS(1) User Commands GROUPS(1)
294
+
295
+ NAME
296
+ groups - print the groups a user is in
297
+
298
+ SYNOPSIS
299
+ groups [USER]
300
+
301
+ DESCRIPTION
302
+ Print group memberships for USER or current user if omitted.`,
303
+ "gzip": `GZIP(1) User Commands GZIP(1)
304
+
305
+ NAME
306
+ gzip, gunzip - compress or expand files
307
+
308
+ SYNOPSIS
309
+ gzip FILE...
310
+ gunzip FILE...
311
+
312
+ DESCRIPTION
313
+ Compress or decompress files in place.`,
314
+ "head": `HEAD(1) User Commands HEAD(1)
315
+
316
+ NAME
317
+ head - output the first part of files
318
+
319
+ SYNOPSIS
320
+ head [OPTION]... [FILE]...
321
+
322
+ OPTIONS
323
+ -n, --lines=[-]NUM print the first NUM lines`,
324
+ "help": `HELP(1) Shell Builtins HELP(1)
325
+
326
+ NAME
327
+ help - display information about builtin commands
328
+
329
+ SYNOPSIS
330
+ help [COMMAND]
331
+
332
+ DESCRIPTION
333
+ With no arguments, list available commands.
334
+ With COMMAND, show usage details for that command.`,
335
+ "history": `HISTORY(1) Shell Builtins HISTORY(1)
336
+
337
+ NAME
338
+ history - command history list
339
+
340
+ SYNOPSIS
341
+ history [N]
342
+
343
+ DESCRIPTION
344
+ Print recent command history entries.
345
+ If N is provided, print only the last N entries.`,
346
+ "hostname": `HOSTNAME(1) User Commands HOSTNAME(1)
347
+
348
+ NAME
349
+ hostname - show or set the system host name
350
+
351
+ SYNOPSIS
352
+ hostname
353
+
354
+ DESCRIPTION
355
+ Print the current host name.`,
356
+ "id": `ID(1) User Commands ID(1)
357
+
358
+ NAME
359
+ id - print real and effective user and group IDs
360
+
361
+ SYNOPSIS
362
+ id [USER]
363
+
364
+ DESCRIPTION
365
+ Print user identity information including uid, gid, and groups.`,
366
+ "kill": `KILL(1) User Commands KILL(1)
367
+
368
+ NAME
369
+ kill - send signals to processes
370
+
371
+ SYNOPSIS
372
+ kill [-SIGNAL] PID...
373
+
374
+ DESCRIPTION
375
+ Send a signal to one or more process IDs.
376
+
377
+ NOTES
378
+ This environment provides a mock process model.`,
379
+ "ls": `LS(1) User Commands LS(1)
380
+
381
+ NAME
382
+ ls - list directory contents
383
+
384
+ SYNOPSIS
385
+ ls [OPTION]... [FILE]...
386
+
387
+ DESCRIPTION
388
+ List information about the FILEs (the current directory by default).
389
+
390
+ OPTIONS
391
+ -l use a long listing format
392
+ -a do not ignore entries starting with .
393
+ -h with -l, print human readable sizes
394
+ -r reverse order while sorting
395
+ -t sort by modification time
396
+
397
+ AUTHOR
398
+ Written by Richard M. Stallman and David MacKenzie.`,
399
+ "lsb_release": `LSB_RELEASE(1) User Commands LSB_RELEASE(1)
400
+
401
+ NAME
402
+ lsb_release - print distribution-specific information
403
+
404
+ SYNOPSIS
405
+ lsb_release [OPTION]...
406
+
407
+ OPTIONS
408
+ -a show all available information
409
+ -i show distributor ID
410
+ -d show description
411
+ -r show release number
412
+ -c show codename`,
413
+ "mkdir": `MKDIR(1) User Commands MKDIR(1)
414
+
415
+ NAME
416
+ mkdir - make directories
417
+
418
+ SYNOPSIS
419
+ mkdir [OPTION]... DIRECTORY...
420
+
421
+ OPTIONS
422
+ -p no error if existing, make parent directories as needed`,
423
+ "mv": `MV(1) User Commands MV(1)
424
+
425
+ NAME
426
+ mv - move (rename) files
427
+
428
+ SYNOPSIS
429
+ mv SOURCE DEST
430
+
431
+ DESCRIPTION
432
+ Rename SOURCE to DEST, or move SOURCE into a destination directory.`,
433
+ "nano": `NANO(1) User Commands NANO(1)
434
+
435
+ NAME
436
+ nano - simple terminal text editor
437
+
438
+ SYNOPSIS
439
+ nano FILE
440
+
441
+ DESCRIPTION
442
+ Open FILE in an interactive editor.
443
+ Save with Ctrl+O, exit with Ctrl+X.`,
444
+ "neofetch": `NEOFETCH(1) User Commands NEOFETCH(1)
445
+
446
+ NAME
447
+ neofetch - display system information
448
+
449
+ SYNOPSIS
450
+ neofetch
451
+
452
+ DESCRIPTION
453
+ Print OS, kernel, uptime, package count, and related system details.`,
454
+ "node": `NODE(1) User Commands NODE(1)
455
+
456
+ NAME
457
+ node - virtual JavaScript runtime entry point
458
+
459
+ SYNOPSIS
460
+ node [--version] [-e SCRIPT] [-p EXPR]
461
+
462
+ DESCRIPTION
463
+ Execute JavaScript snippets in the virtual runtime.
464
+
465
+ NOTES
466
+ Requires package installation: apt install nodejs.`,
467
+ "npm": `NPM(1) User Commands NPM(1)
468
+
469
+ NAME
470
+ npm - virtual Node.js package manager interface
471
+
472
+ SYNOPSIS
473
+ npm [--version] [COMMAND]
474
+
475
+ DESCRIPTION
476
+ Manage packages and run scripts in the virtual environment.
477
+
478
+ NOTES
479
+ Requires package installation: apt install npm.`,
480
+ "npx": `NPX(1) User Commands NPX(1)
481
+
482
+ NAME
483
+ npx - execute package binaries from npm
484
+
485
+ SYNOPSIS
486
+ npx [--version] <command>
487
+
488
+ DESCRIPTION
489
+ Run package executables in the virtual environment.
490
+
491
+ NOTES
492
+ Requires package installation: apt install npm.`,
493
+ "passwd": `PASSWD(1) User Commands PASSWD(1)
494
+
495
+ NAME
496
+ passwd - change user password
497
+
498
+ SYNOPSIS
499
+ passwd [USER]
500
+
501
+ DESCRIPTION
502
+ Update the authentication token (password) for USER.
503
+ Without USER, change the current user's password.`,
504
+ "ping": `PING(8) User Commands PING(8)
505
+
506
+ NAME
507
+ ping - send ICMP ECHO_REQUEST to network hosts
508
+
509
+ SYNOPSIS
510
+ ping [-c COUNT] DESTINATION
511
+
512
+ OPTIONS
513
+ -c COUNT stop after sending COUNT packets`,
514
+ "printf": `PRINTF(1) User Commands PRINTF(1)
515
+
516
+ NAME
517
+ printf - format and print data
518
+
519
+ SYNOPSIS
520
+ printf FORMAT [ARGUMENT]...
521
+
522
+ DESCRIPTION
523
+ Print ARGUMENT(s) according to FORMAT.
524
+ Supports common conversions like %s, %d, %f, %x and escapes like \\n.`,
525
+ "ps": `PS(1) User Commands PS(1)
526
+
527
+ NAME
528
+ ps - report a snapshot of current processes
529
+
530
+ SYNOPSIS
531
+ ps [OPTION]
532
+
533
+ DESCRIPTION
534
+ Show process information for active sessions and commands.`,
535
+ "pwd": `PWD(1) User Commands PWD(1)
536
+
537
+ NAME
538
+ pwd - print name of current working directory
539
+
540
+ SYNOPSIS
541
+ pwd
542
+
543
+ DESCRIPTION
544
+ Print the absolute path of the current directory.`,
545
+ "python3": `PYTHON3(1) User Commands PYTHON3(1)
546
+
547
+ NAME
548
+ python3 - virtual Python 3 interpreter entry point
549
+
550
+ SYNOPSIS
551
+ python3 [--version] [-V] [-c COMMAND]
552
+
553
+ DESCRIPTION
554
+ Execute Python snippets in the virtual runtime.
555
+
556
+ NOTES
557
+ Requires package installation: apt install python3.`,
558
+ "readlink": `READLINK(1) User Commands READLINK(1)
559
+
560
+ NAME
561
+ readlink - print resolved symbolic links or canonical file names
562
+
563
+ SYNOPSIS
564
+ readlink [OPTION]... FILE
565
+
566
+ OPTIONS
567
+ -f canonicalize by following every symlink in every component`,
568
+ "return": `RETURN(1) Shell Builtins RETURN(1)
569
+
570
+ NAME
571
+ return - return from a shell function
572
+
573
+ SYNOPSIS
574
+ return [N]
575
+
576
+ DESCRIPTION
577
+ Cause a function to exit with status N (default: last status).`,
578
+ "rm": `RM(1) User Commands RM(1)
579
+
580
+ NAME
581
+ rm - remove files or directories
582
+
583
+ SYNOPSIS
584
+ rm [OPTION]... FILE...
585
+
586
+ OPTIONS
587
+ -r remove directories and their contents recursively`,
588
+ "sed": `SED(1) User Commands SED(1)
589
+
590
+ NAME
591
+ sed - stream editor for filtering and transforming text
592
+
593
+ SYNOPSIS
594
+ sed [OPTION]... {-e script} [FILE]...
595
+
596
+ OPTIONS
597
+ -e SCRIPT add SCRIPT to commands to be executed
598
+ -i edit files in place`,
599
+ "set": `SET(1) Shell Builtins SET(1)
600
+
601
+ NAME
602
+ set - set or unset shell options and positional parameters
603
+
604
+ SYNOPSIS
605
+ set [OPTION]... [ARG]...
606
+ set [NAME=VALUE]...
607
+
608
+ DESCRIPTION
609
+ Display or modify shell variable state.`,
610
+ "shift": `SHIFT(1) Shell Builtins SHIFT(1)
611
+
612
+ NAME
613
+ shift - shift positional parameters
614
+
615
+ SYNOPSIS
616
+ shift [N]
617
+
618
+ DESCRIPTION
619
+ Rename positional parameters by discarding the first N arguments.`,
620
+ "sleep": `SLEEP(1) User Commands SLEEP(1)
621
+
622
+ NAME
623
+ sleep - delay for a specified amount of time
624
+
625
+ SYNOPSIS
626
+ sleep NUMBER
627
+
628
+ DESCRIPTION
629
+ Pause execution for NUMBER seconds.`,
630
+ "sort": `SORT(1) User Commands SORT(1)
631
+
632
+ NAME
633
+ sort - sort lines of text files
634
+
635
+ SYNOPSIS
636
+ sort [OPTION]... [FILE]...
637
+
638
+ OPTIONS
639
+ -r reverse the result of comparisons
640
+ -n compare according to string numerical value
641
+ -u output only the first of an equal run`,
642
+ "source": `SOURCE(1) Shell Builtins SOURCE(1)
643
+
644
+ NAME
645
+ source - execute commands from a file in the current shell
646
+
647
+ SYNOPSIS
648
+ source FILE
649
+ . FILE
650
+
651
+ DESCRIPTION
652
+ Read and execute commands from FILE in the current shell context.`,
653
+ "ssh": `SSH(1) OpenSSH SSH(1)
654
+
655
+ NAME
656
+ ssh - OpenSSH remote login client
657
+
658
+ SYNOPSIS
659
+ ssh [-p port] [user@]hostname [command]
660
+
661
+ DESCRIPTION
662
+ ssh (SSH client) is a program for logging into a remote machine and
663
+ for executing commands on a remote machine.`,
664
+ "stat": `STAT(1) User Commands STAT(1)
665
+
666
+ NAME
667
+ stat - display file status
668
+
669
+ SYNOPSIS
670
+ stat [OPTION]... FILE...
671
+
672
+ OPTIONS
673
+ -c, --format=FORMAT use the specified output format`,
674
+ "su": `SU(1) User Commands SU(1)
675
+
676
+ NAME
677
+ su - run a command with substitute user and group ID
678
+
679
+ SYNOPSIS
680
+ su [OPTION]... [USER]
681
+
682
+ OPTIONS
683
+ - start a login shell
684
+
685
+ DESCRIPTION
686
+ Switch to another user account in the current session.`,
687
+ "sudo": `SUDO(8) User Commands SUDO(8)
688
+
689
+ NAME
690
+ sudo - execute a command as another user
691
+
692
+ SYNOPSIS
693
+ sudo [OPTION]... COMMAND [ARG]...
694
+
695
+ OPTIONS
696
+ -i run login shell as target user
697
+ -u USER run command as USER`,
698
+ "tail": `TAIL(1) User Commands TAIL(1)
699
+
700
+ NAME
701
+ tail - output the last part of files
702
+
703
+ SYNOPSIS
704
+ tail [OPTION]... [FILE]...
705
+
706
+ OPTIONS
707
+ -n, --lines=[+]NUM output the last NUM lines`,
708
+ "tar": `TAR(1) GNU tar Manual TAR(1)
709
+
710
+ NAME
711
+ tar - an archiving utility
712
+
713
+ SYNOPSIS
714
+ tar [OPTION...] [FILE]...
715
+
716
+ DESCRIPTION
717
+ tar saves many files together into a single tape or disk archive,
718
+ and can restore individual files from the archive.
719
+
720
+ OPTIONS
721
+ -c, --create create a new archive
722
+ -x, --extract extract files from an archive
723
+ -z, --gzip filter the archive through gzip
724
+ -f, --file=ARCHIVE use archive file or device ARCHIVE
725
+ -v, --verbose verbosely list files processed
726
+ -t, --list list the contents of an archive`,
727
+ "tee": `TEE(1) User Commands TEE(1)
728
+
729
+ NAME
730
+ tee - read from standard input and write to standard output and files
731
+
732
+ SYNOPSIS
733
+ tee [OPTION]... [FILE]...
734
+
735
+ OPTIONS
736
+ -a append to the given FILEs, do not overwrite`,
737
+ "test": `TEST(1) Shell Builtins TEST(1)
738
+
739
+ NAME
740
+ test - check file types and compare values
741
+
742
+ SYNOPSIS
743
+ test EXPRESSION
744
+ [ EXPRESSION ]
745
+
746
+ DESCRIPTION
747
+ Evaluate conditional expressions for scripts and shell logic.`,
748
+ "touch": `TOUCH(1) User Commands TOUCH(1)
749
+
750
+ NAME
751
+ touch - change file timestamps / create file
752
+
753
+ SYNOPSIS
754
+ touch FILE...
755
+
756
+ DESCRIPTION
757
+ Update access and modification times.
758
+ If FILE does not exist, create an empty file.`,
759
+ "tr": `TR(1) User Commands TR(1)
760
+
761
+ NAME
762
+ tr - translate or delete characters
763
+
764
+ SYNOPSIS
765
+ tr [OPTION]... SET1 [SET2]
766
+
767
+ OPTIONS
768
+ -d delete characters in SET1 instead of translating`,
769
+ "trap": `TRAP(1) Shell Builtins TRAP(1)
770
+
771
+ NAME
772
+ trap - trap signals and other events
773
+
774
+ SYNOPSIS
775
+ trap [ACTION] [SIGNAL]...
776
+
777
+ DESCRIPTION
778
+ Define or clear handlers for shell signals and EXIT.`,
779
+ "true": `TRUE(1) User Commands TRUE(1)
780
+
781
+ NAME
782
+ true - do nothing, successfully
783
+
784
+ SYNOPSIS
785
+ true
786
+
787
+ DESCRIPTION
788
+ Exit with a status code indicating success (0).`,
789
+ "type": `TYPE(1) Shell Builtins TYPE(1)
790
+
791
+ NAME
792
+ type - display how a command name is interpreted
793
+
794
+ SYNOPSIS
795
+ type NAME...
796
+
797
+ DESCRIPTION
798
+ Indicate whether NAME is a shell builtin, alias, or found in PATH.`,
799
+ "uname": `UNAME(1) User Commands UNAME(1)
800
+
801
+ NAME
802
+ uname - print system information
803
+
804
+ SYNOPSIS
805
+ uname [OPTION]...
806
+
807
+ OPTIONS
808
+ -a print all information
809
+ -r print kernel release
810
+ -m print machine hardware name`,
811
+ "uniq": `UNIQ(1) User Commands UNIQ(1)
812
+
813
+ NAME
814
+ uniq - report or omit repeated lines
815
+
816
+ SYNOPSIS
817
+ uniq [OPTION]... [INPUT [OUTPUT]]
818
+
819
+ OPTIONS
820
+ -c prefix lines by the number of occurrences
821
+ -d only print duplicate lines
822
+ -u only print unique lines`,
823
+ "unset": `UNSET(1) Shell Builtins UNSET(1)
824
+
825
+ NAME
826
+ unset - unset values and attributes of shell variables
827
+
828
+ SYNOPSIS
829
+ unset NAME...
830
+
831
+ DESCRIPTION
832
+ Remove one or more shell variables from the current environment.`,
833
+ "uptime": `UPTIME(1) User Commands UPTIME(1)
834
+
835
+ NAME
836
+ uptime - tell how long the system has been running
837
+
838
+ SYNOPSIS
839
+ uptime [OPTION]
840
+
841
+ OPTIONS
842
+ -p show uptime in a pretty format
843
+ -s show system up since time`,
844
+ "wc": `WC(1) User Commands WC(1)
845
+
846
+ NAME
847
+ wc - print newline, word, and byte counts for each file
848
+
849
+ SYNOPSIS
850
+ wc [OPTION]... [FILE]...
851
+
852
+ OPTIONS
853
+ -l print the newline counts
854
+ -w print the word counts
855
+ -c print the byte counts`,
856
+ "wget": `WGET(1) User Commands WGET(1)
857
+
858
+ NAME
859
+ wget - non-interactive network downloader
860
+
861
+ SYNOPSIS
862
+ wget [OPTION]... [URL]...
863
+
864
+ OPTIONS
865
+ -O FILE write documents to FILE
866
+ -P DIR save files to DIR
867
+ -q quiet mode`,
868
+ "which": `WHICH(1) User Commands WHICH(1)
869
+
870
+ NAME
871
+ which - locate a command
872
+
873
+ SYNOPSIS
874
+ which COMMAND...
875
+
876
+ DESCRIPTION
877
+ Print the path of COMMAND found in $PATH.`,
878
+ "whoami": `WHOAMI(1) User Commands WHOAMI(1)
879
+
880
+ NAME
881
+ whoami - print effective user name
882
+
883
+ SYNOPSIS
884
+ whoami
885
+
886
+ DESCRIPTION
887
+ Print the user name associated with the current effective user ID.`,
888
+ "xargs": `XARGS(1) User Commands XARGS(1)
889
+
890
+ NAME
891
+ xargs - build and execute command lines from standard input
892
+
893
+ SYNOPSIS
894
+ xargs [COMMAND [INITIAL-ARGS]]
895
+
896
+ DESCRIPTION
897
+ Read items from stdin and execute COMMAND with those items as arguments.`,
898
+ } as const;