mcp-redhat-manpage-data 0.1.0 → 0.1.1
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.
- package/.github/workflows/extract.yml +11 -6
- package/manpages/rhel10/groff.1.txt +10 -11
- package/manpages/rhel10/grops.1.txt +32 -33
- package/manpages/rhel10/grotty.1.txt +2 -3
- package/manpages/rhel10/pic.1.txt +3 -3
- package/manpages/rhel10/tbl.1.txt +1 -2
- package/manpages/rhel10/troff.1.txt +3 -4
- package/manpages/rhel8/groff.1.txt +16 -20
- package/manpages/rhel8/grops.1.txt +22 -24
- package/manpages/rhel8/troff.1.txt +1 -2
- package/manpages/rhel9/groff.1.txt +10 -12
- package/manpages/rhel9/grops.1.txt +17 -19
- package/manpages/rhel9/pic.1.txt +5 -5
- package/manpages/rhel9/troff.1.txt +1 -1
- package/package.json +5 -1
- package/manpages/rhel10/.k5identity.5.txt +0 -50
- package/manpages/rhel10/.k5login.5.txt +0 -44
- package/manpages/rhel8/.k5identity.5.txt +0 -50
- package/manpages/rhel8/.k5login.5.txt +0 -44
- package/manpages/rhel9/.k5identity.5.txt +0 -50
- package/manpages/rhel9/.k5login.5.txt +0 -44
|
@@ -9,15 +9,21 @@ on:
|
|
|
9
9
|
jobs:
|
|
10
10
|
extract:
|
|
11
11
|
runs-on: ubuntu-latest
|
|
12
|
+
permissions:
|
|
13
|
+
contents: write
|
|
14
|
+
id-token: write
|
|
12
15
|
|
|
13
16
|
steps:
|
|
14
17
|
- uses: actions/checkout@v4
|
|
15
18
|
|
|
16
19
|
- uses: actions/setup-node@v4
|
|
17
20
|
with:
|
|
18
|
-
node-version: '
|
|
21
|
+
node-version: '22'
|
|
19
22
|
registry-url: 'https://registry.npmjs.org'
|
|
20
23
|
|
|
24
|
+
- name: Upgrade npm
|
|
25
|
+
run: npm install -g npm@latest
|
|
26
|
+
|
|
21
27
|
- name: Extract man pages
|
|
22
28
|
run: bash scripts/extract.sh
|
|
23
29
|
|
|
@@ -42,13 +48,12 @@ jobs:
|
|
|
42
48
|
git diff --cached --stat
|
|
43
49
|
fi
|
|
44
50
|
|
|
45
|
-
- name:
|
|
51
|
+
- name: Commit, bump version, and publish
|
|
46
52
|
if: steps.changes.outputs.changed == 'true'
|
|
47
|
-
env:
|
|
48
|
-
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
|
|
49
53
|
run: |
|
|
50
54
|
git config user.name "github-actions[bot]"
|
|
51
55
|
git config user.email "github-actions[bot]@users.noreply.github.com"
|
|
52
|
-
|
|
53
|
-
npm
|
|
56
|
+
git commit -m "Update man pages from latest UBI images"
|
|
57
|
+
npm version patch -m "v%s"
|
|
58
|
+
npm publish --provenance --access public
|
|
54
59
|
git push --follow-tags
|
|
@@ -330,8 +330,8 @@ Usage
|
|
|
330
330
|
to s; see groff_mm(7). It can be specified on the command line as -mm.
|
|
331
331
|
|
|
332
332
|
om (invariably called “mom”) is a modern package written by Peter Schaffter specifically for GNU roff.
|
|
333
|
-
Consult the mom
|
|
334
|
-
|
|
333
|
+
Consult the mom HTML manual for extensive documentation. She—for mom takes the female pronoun—can be
|
|
334
|
+
specified on the command line as -mom.
|
|
335
335
|
|
|
336
336
|
s is the original AT&T general-purpose document format; see groff_ms(7). It can be specified on the com‐
|
|
337
337
|
mand line as -ms.
|
|
@@ -634,18 +634,17 @@ Installation directories
|
|
|
634
634
|
|
|
635
635
|
Availability
|
|
636
636
|
Obtain links to groff releases for download, its source repository, discussion mailing lists, a support ticket
|
|
637
|
-
tracker, and further information from the groff page of the GNU website
|
|
637
|
+
tracker, and further information from the groff page of the GNU website.
|
|
638
638
|
|
|
639
|
-
A free implementation of the grap preprocessor, written by Ted Faber
|
|
640
|
-
|
|
639
|
+
A free implementation of the grap preprocessor, written by Ted Faber, can be found at the grap website. groff
|
|
640
|
+
supports only this grap.
|
|
641
641
|
|
|
642
642
|
Authors
|
|
643
|
-
groff (both
|
|
644
|
-
|
|
645
|
-
Warken ⟨groff-bernd.warken-72@web.de⟩, and G. Branden Robinson ⟨g.branden.robinson@gmail.com⟩.
|
|
643
|
+
groff (both the front-end command and the overall system) was primarily written by James Clark. Contributors
|
|
644
|
+
to this document include Clark, Trent A. Fisher, Werner Lemberg, Bernd Warken, and G. Branden Robinson.
|
|
646
645
|
|
|
647
646
|
See also
|
|
648
|
-
Groff:
|
|
647
|
+
Groff: The GNU Implementation of troff, by Trent A. Fisher and Werner Lemberg, is the primary groff manual.
|
|
649
648
|
You can browse it interactively with “info groff”.
|
|
650
649
|
|
|
651
650
|
Introduction, history, and further reading:
|
|
@@ -655,11 +654,11 @@ See also
|
|
|
655
654
|
gxditview(1)
|
|
656
655
|
|
|
657
656
|
Preprocessors:
|
|
658
|
-
chem(1),
|
|
657
|
+
chem(1), eqn(1), neqn(1), glilypond(1), grn(1), preconv(1), gperl(1), pic(1), gpinyin(1), refer(1),
|
|
659
658
|
soelim(1), tbl(1)
|
|
660
659
|
|
|
661
660
|
Macro packages and package-specific utilities:
|
|
662
|
-
groff_hdtbl(7),
|
|
661
|
+
groff_hdtbl(7), groff_man(7), groff_man_style(7), groff_mdoc(7), groff_me(7), groff_mm(7),
|
|
663
662
|
groff_mmse(7), mmroff(1), groff_mom(7), pdfmom(1), groff_ms(7), groff_rfc1345(7), groff_trace(7),
|
|
664
663
|
groff_www(7)
|
|
665
664
|
|
|
@@ -316,9 +316,9 @@ Usage
|
|
|
316
316
|
the PFA format described in pfbtops(1). Several methods exist to generate a Type 42 wrapper; some of them in‐
|
|
317
317
|
volve the use of a PostScript interpreter such as Ghostscript—see gs(1).
|
|
318
318
|
|
|
319
|
-
One approach is to use FontForge
|
|
320
|
-
|
|
321
|
-
|
|
319
|
+
One approach is to use FontForge, a font editor that can convert most outline font formats. Here's an example
|
|
320
|
+
of using the Roboto Slab Serif font with groff. Several variables are used so that you can more easily adapt
|
|
321
|
+
it into your own script.
|
|
322
322
|
|
|
323
323
|
MAP=/usr/share/groff/1.23.0/font/devps/generate/text.map
|
|
324
324
|
TTF=/usr/share/fonts/truetype/roboto/slab/RobotoSlab-Regular.ttf
|
|
@@ -334,13 +334,13 @@ Usage
|
|
|
334
334
|
afmtodit "$DIR/devps/$AFM" "$MAP" "$DIR/devps/$GFN"
|
|
335
335
|
printf "$BASE\t$PFA\n" >> "$DIR/devps/download"
|
|
336
336
|
|
|
337
|
-
fontforge
|
|
337
|
+
fontforge and afmtodit may generate warnings depending on the attributes of the font. The test procedure is
|
|
338
338
|
simple.
|
|
339
339
|
|
|
340
340
|
printf ".ft RSR\nHello, world!\n" | groff -F "$DIR" > hello.ps
|
|
341
341
|
|
|
342
|
-
Once
|
|
343
|
-
stance,
|
|
342
|
+
Once you're satisfied that the font works, you may want to generate any available related styles (for in‐
|
|
343
|
+
stance, Roboto Slab also has “Bold”, “Light”, and “Thin” styles) and set up GROFF_FONT_PATH in your environ‐
|
|
344
344
|
ment to include the directory you keep the generated fonts in so that you don't have to use the -F option.
|
|
345
345
|
|
|
346
346
|
Font installation
|
|
@@ -349,35 +349,35 @@ Font installation
|
|
|
349
349
|
• Convert your font to something groff understands. This is a PostScript Type 1 font in PFA format or a Post‐
|
|
350
350
|
Script Type 42 font, together with an AFM file. A PFA file begins as follows.
|
|
351
351
|
%!PS-AdobeFont-1.0:
|
|
352
|
-
A
|
|
352
|
+
A PFB file contains this string as well, preceded by some non-printing bytes. If your font is in PFB for‐
|
|
353
353
|
mat, use groff's pfbtops(1) program to convert it to PFA. For TrueType and other font formats, we recommend
|
|
354
354
|
fontforge, which can convert most outline font formats. A Type 42 font file begins as follows.
|
|
355
355
|
%!PS-TrueTypeFont
|
|
356
|
-
This
|
|
357
|
-
might
|
|
358
|
-
CTAN's BrushScriptX-Italic
|
|
356
|
+
This is a wrapper format for TrueType fonts. Old PostScript printers might not support them (that is, they
|
|
357
|
+
might not have a built-in TrueType font interpreter). In the following steps, we will consider the use of
|
|
358
|
+
CTAN's BrushScriptX-Italic font in PFA format.
|
|
359
359
|
|
|
360
360
|
• Convert the AFM file to a groff font description file with the afmtodit(1) program. For instance,
|
|
361
361
|
$ afmtodit BrushScriptX-Italic.afm text.map BSI
|
|
362
362
|
converts the Adobe Font Metric file BrushScriptX-Italic.afm to the groff font description file BSI.
|
|
363
363
|
|
|
364
|
-
If
|
|
365
|
-
(where
|
|
366
|
-
tively,
|
|
367
|
-
tures.
|
|
368
|
-
groff
|
|
364
|
+
If you have a font family which provides regular upright (roman), bold, italic, and bold-italic styles
|
|
365
|
+
(where “italic” may be “oblique” or “slanted”), we recommend using the letters R, B, I, and BI, respec‐
|
|
366
|
+
tively, as suffixes to the groff font family name to enable groff's font family and style selection fea‐
|
|
367
|
+
tures. An example is groff's built-in support for Times: the font family name is abbreviated as T, and the
|
|
368
|
+
groff font names are therefore TR, TB, TI, and TBI. In our example, however, the BrushScriptX font is
|
|
369
369
|
available in a single style only, italic.
|
|
370
370
|
|
|
371
|
-
• Install
|
|
372
|
-
device
|
|
371
|
+
• Install the groff font description file(s) in a devps subdirectory in the search path that groff uses for
|
|
372
|
+
device and font file descriptions. See the GROFF_FONT_PATH entry in section “Environment” of troff(1) for
|
|
373
373
|
the current value of the font search path. While groff doesn't directly use AFM files, it is a good idea to
|
|
374
374
|
store them alongside its font description files.
|
|
375
375
|
|
|
376
|
-
• Register
|
|
376
|
+
• Register fonts in the devps/download file so they can be located for embedding in PostScript files grops
|
|
377
377
|
generates. Only the first download file encountered in the font search path is read. If in doubt, copy the
|
|
378
|
-
default
|
|
379
|
-
your
|
|
380
|
-
font
|
|
378
|
+
default download file (see section “Files” below) to the first directory in the font search path and add
|
|
379
|
+
your fonts there. The PostScript font name used by grops is stored in the internalname field in the groff
|
|
380
|
+
font description file. (This name does not necessarily resemble the font's file name.) We add the follow‐
|
|
381
381
|
ing line to download.
|
|
382
382
|
BrushScriptX-Italic→BrushScriptX-Italic.pfa
|
|
383
383
|
A tab character, depicted as →, separates the fields.
|
|
@@ -392,7 +392,7 @@ Old fonts
|
|
|
392
392
|
has 314 glyphs and includes the Euro glyph. For backwards compatibility, these old font descriptions are also
|
|
393
393
|
installed in the /usr/share/groff/1.23.0/oldfont/devps directory.
|
|
394
394
|
|
|
395
|
-
To
|
|
395
|
+
To use them, make sure that grops finds the fonts before the default system fonts (with the same names): ei‐
|
|
396
396
|
ther give grops the -F command-line option,
|
|
397
397
|
$ groff -Tps -P-F -P/usr/share/groff/1.23.0/oldfont ...
|
|
398
398
|
or add the directory to groff's font and device description search path environment variable,
|
|
@@ -402,15 +402,15 @@ Old fonts
|
|
|
402
402
|
|
|
403
403
|
Environment
|
|
404
404
|
GROFF_FONT_PATH
|
|
405
|
-
A
|
|
405
|
+
A list of directories in which to seek the selected output device's directory of device and font de‐
|
|
406
406
|
scription files. See troff(1) and groff_font(5).
|
|
407
407
|
|
|
408
408
|
GROPS_PROLOGUE
|
|
409
|
-
If
|
|
409
|
+
If this is set to foo, then grops uses the file foo (in the font path) instead of the default prologue
|
|
410
410
|
file prologue. The option -P overrides this environment variable.
|
|
411
411
|
|
|
412
412
|
SOURCE_DATE_EPOCH
|
|
413
|
-
A
|
|
413
|
+
A timestamp (expressed as seconds since the Unix epoch) to use as the output creation timestamp in
|
|
414
414
|
place of the current time. The time is converted to human-readable form using ctime(3) and recorded in
|
|
415
415
|
a PostScript comment.
|
|
416
416
|
|
|
@@ -431,28 +431,27 @@ Files
|
|
|
431
431
|
is the default PostScript prologue prefixed to every output file.
|
|
432
432
|
|
|
433
433
|
/usr/share/groff/1.23.0/font/devps/text.enc
|
|
434
|
-
describes
|
|
434
|
+
describes the encoding scheme used by most PostScript Type 1 fonts; the encoding directive of font de‐
|
|
435
435
|
scription files for the ps device refers to it.
|
|
436
436
|
|
|
437
437
|
/usr/share/groff/1.23.0/tmac/ps.tmac
|
|
438
|
-
defines
|
|
438
|
+
defines macros for use with the ps output device. It is automatically loaded by troffrc when the ps
|
|
439
439
|
output device is selected.
|
|
440
440
|
|
|
441
441
|
/usr/share/groff/1.23.0/tmac/pspic.tmac
|
|
442
|
-
defines
|
|
442
|
+
defines the PSPIC macro for embedding images in a document; see groff_tmac(5). It is automatically
|
|
443
443
|
loaded by troffrc.
|
|
444
444
|
|
|
445
445
|
/usr/share/groff/1.23.0/tmac/psold.tmac
|
|
446
|
-
provides
|
|
447
|
-
set;
|
|
446
|
+
provides replacement glyphs for text fonts that lack complete coverage of the ISO Latin-1 character
|
|
447
|
+
set; using it, groff can produce glyphs like eth (ð) and thorn (þ) that older PostScript printers do
|
|
448
448
|
not natively support.
|
|
449
449
|
|
|
450
|
-
grops
|
|
450
|
+
grops creates temporary files using the template “gropsXXXXXX”; see groff(1) for details on their storage lo‐
|
|
451
451
|
cation.
|
|
452
452
|
|
|
453
453
|
See also
|
|
454
|
-
PostScript
|
|
455
|
-
developer/en/ps/5001.DSC_Spec.pdf⟩
|
|
454
|
+
PostScript Language Document Structuring Conventions Specification
|
|
456
455
|
|
|
457
456
|
afmtodit(1), groff(1), troff(1), pfbtops(1), groff_char(7), groff_font(5), groff_out(5), groff_tmac(5)
|
|
458
457
|
|
|
@@ -188,10 +188,9 @@ Examples
|
|
|
188
188
|
See also
|
|
189
189
|
“Control Functions for Coded Character Sets” (ECMA-48) 5th edition, Ecma International, June 1991. A gratis
|
|
190
190
|
version of ISO 6429, this document includes a normative description of SGR escape sequences. Available at
|
|
191
|
-
|
|
191
|
+
http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-048.pdf.
|
|
192
192
|
|
|
193
|
-
“Hyperlinks
|
|
194
|
-
Egmont Koblinger.
|
|
193
|
+
“Hyperlinks in Terminal Emulators”, Egmont Koblinger.
|
|
195
194
|
|
|
196
195
|
groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7), ul(1), more(1), less(1), man(1)
|
|
197
196
|
|
|
@@ -395,11 +395,11 @@ See also
|
|
|
395
395
|
“PIC—A Graphics Language for Typesetting: User Manual”, by Brian W. Kernighan, 1984 (revised 1991), AT&T Bell
|
|
396
396
|
Laboratories Computing Science Technical Report No. 116
|
|
397
397
|
|
|
398
|
-
ps2eps is available from CTAN mirrors, e.g.,
|
|
398
|
+
ps2eps is available from CTAN mirrors, e.g., ftp://ftp.dante.de/tex-archive/support/ps2eps/
|
|
399
399
|
|
|
400
|
-
W. Richard Stevens, Turning PIC into HTML
|
|
400
|
+
W. Richard Stevens, Turning PIC into HTML
|
|
401
401
|
|
|
402
|
-
W. Richard Stevens, Examples of pic Macros
|
|
402
|
+
W. Richard Stevens, Examples of pic Macros
|
|
403
403
|
|
|
404
404
|
troff(1), groff_out(5), tex(1), gs(1), ps2eps(1), pstopnm(1), ps2epsi(1), pnm(5)
|
|
405
405
|
|
|
@@ -538,8 +538,7 @@ See also
|
|
|
538
538
|
“Tbl—A Program to Format Tables”, by M. E. Lesk, 1976 (revised 16 January 1979), AT&T Bell Laboratories Com‐
|
|
539
539
|
puting Science Technical Report No. 49.
|
|
540
540
|
|
|
541
|
-
The
|
|
542
|
-
⟨https://man.openbsd.org/tbl.7⟩.
|
|
541
|
+
The spanning example above was taken from mandoc's man page for its tbl implementation.
|
|
543
542
|
|
|
544
543
|
groff(1), troff(1)
|
|
545
544
|
|
|
@@ -262,11 +262,10 @@ Files
|
|
|
262
262
|
|
|
263
263
|
Authors
|
|
264
264
|
The GNU version of troff was originally written by James Clark; he also wrote the original version of this
|
|
265
|
-
document,
|
|
266
|
-
G. Branden Robinson ⟨g.branden.robinson@gmail.com⟩.
|
|
265
|
+
document, which was updated by Werner Lemberg, Bernd Warken, and G. Branden Robinson.
|
|
267
266
|
|
|
268
267
|
See also
|
|
269
|
-
Groff:
|
|
268
|
+
Groff: The GNU Implementation of troff, by Trent A. Fisher and Werner Lemberg, is the primary groff manual.
|
|
270
269
|
You can browse it interactively with “info groff”.
|
|
271
270
|
|
|
272
271
|
groff(1)
|
|
@@ -277,7 +276,7 @@ See also
|
|
|
277
276
|
ters, and escape sequences.
|
|
278
277
|
|
|
279
278
|
groff_char(7)
|
|
280
|
-
explains
|
|
279
|
+
explains the syntax of groff special character escape sequences, and lists all special characters pre‐
|
|
281
280
|
defined by the language.
|
|
282
281
|
|
|
283
282
|
groff_diff(7)
|
|
@@ -12,7 +12,7 @@ SYNOPSIS
|
|
|
12
12
|
DESCRIPTION
|
|
13
13
|
This document describes the groff program, the main front-end for the groff document formatting system. The
|
|
14
14
|
groff program and macro suite is the implementation of a roff(7) system within the free software collection
|
|
15
|
-
GNU
|
|
15
|
+
GNU. The groff system has all features of the classical roff, but adds many extensions.
|
|
16
16
|
|
|
17
17
|
The groff program allows to control the whole groff system by command line options. This is a great simplifi‐
|
|
18
18
|
cation in comparison to the classical case (which uses pipes only).
|
|
@@ -493,8 +493,8 @@ BUGS
|
|
|
493
493
|
On EBCDIC hosts (e.g., OS/390 Unix), output devices ascii and latin1 aren't available. Similarly, output for
|
|
494
494
|
EBCDIC code page cp1047 is not available on ASCII based operating systems.
|
|
495
495
|
|
|
496
|
-
Report bugs to
|
|
497
|
-
|
|
496
|
+
Report bugs to the groff mailing list. Include a complete, self-contained example that allows the bug to be
|
|
497
|
+
reproduced, and say which version of groff you are using.
|
|
498
498
|
|
|
499
499
|
POSITIONS FROM INSTALLATION
|
|
500
500
|
There are some directories in which groff installs all of its data files. Due to different installation
|
|
@@ -583,24 +583,21 @@ POSITIONS FROM INSTALLATION
|
|
|
583
583
|
Font file for font F of device name.
|
|
584
584
|
|
|
585
585
|
AVAILABILITY
|
|
586
|
-
Information
|
|
587
|
-
www.gnu.org/software/groff⟩.
|
|
586
|
+
Information on how to get groff and related information is available at the groff GNU website.
|
|
588
587
|
|
|
589
588
|
Three groff mailing lists are available:
|
|
590
589
|
|
|
591
|
-
for reporting bugs
|
|
590
|
+
for reporting bugs.
|
|
592
591
|
|
|
593
|
-
for general discussion of groff
|
|
592
|
+
for general discussion of groff,.
|
|
594
593
|
|
|
595
|
-
the groff commit list
|
|
596
|
-
groff repository.
|
|
594
|
+
the groff commit list, a read-only list showing logs of commitments to the groff repository.
|
|
597
595
|
|
|
598
596
|
Details on repository access and much more can be found in the file README at the top directory of the groff
|
|
599
597
|
source package.
|
|
600
598
|
|
|
601
|
-
There is a free implementation of the grap preprocessor, written by Ted Faber
|
|
602
|
-
|
|
603
|
-
the only grap version supported by groff.
|
|
599
|
+
There is a free implementation of the grap preprocessor, written by Ted Faber. The actual version can be
|
|
600
|
+
found at the grap website. This is the only grap version supported by groff.
|
|
604
601
|
|
|
605
602
|
SEE ALSO
|
|
606
603
|
The groff info file contains all information on the groff system within a single document, providing many ex‐
|
|
@@ -641,12 +638,12 @@ SEE ALSO
|
|
|
641
638
|
grodvi(1), grohtml(1), grolbp(1), grolj4(1), lj4_font(5), grops(1), gropdf(1), grotty(1).
|
|
642
639
|
|
|
643
640
|
Groff macro packages and macro-specific utilities:
|
|
644
|
-
groff_tmac(5),
|
|
641
|
+
groff_tmac(5), groff_man(7), groff_mdoc(7), groff_me(7), groff_mm(7), groff_mmse(7), groff_mom(7),
|
|
645
642
|
groff_ms(7), groff_www(7), groff_trace(7), mmroff(7).
|
|
646
643
|
|
|
647
644
|
The following utilities are available:
|
|
648
|
-
addftinfo(1),
|
|
649
|
-
hpftodit(1),
|
|
645
|
+
addftinfo(1), afmtodit(1), eqn2graph(1), gdiffmk(1), grap2graph(1), groffer(1), gxditview(1),
|
|
646
|
+
hpftodit(1), indxbib(1), lkbib(1), lookbib(1), pdfroff(1), pfbtops(1), pic2graph(1), tfmtodit(1),
|
|
650
647
|
xtotroff(1).
|
|
651
648
|
|
|
652
649
|
COPYING (LICENSE)
|
|
@@ -660,14 +657,13 @@ COPYING (LICENSE)
|
|
|
660
657
|
tation License, Version 1.3 or any later version published by the Free Software Foundation; with the Invariant
|
|
661
658
|
Sections being the macro definition or .co and .au, with no Front-Cover Texts, and with no Back-Cover Texts.
|
|
662
659
|
|
|
663
|
-
A
|
|
660
|
+
A copy of the Free Documentation License is included as a file called FDL in the main directory of the groff
|
|
664
661
|
source package.
|
|
665
662
|
|
|
666
|
-
It is also available in the internet at the GNU copyleft site
|
|
663
|
+
It is also available in the internet at the GNU copyleft site.
|
|
667
664
|
|
|
668
665
|
AUTHORS
|
|
669
|
-
This document is based on the original groff man page written by James Clark
|
|
670
|
-
|
|
671
|
-
by Werner Lemberg ⟨wl@gnu.org⟩.
|
|
666
|
+
This document is based on the original groff man page written by James Clark. It was rewritten, enhanced, and
|
|
667
|
+
put under the FDL license by Bernd Warken <groff-bernd.warken-72@web.de>. It is maintained by Werner Lemberg.
|
|
672
668
|
|
|
673
669
|
Groff Version 1.22.3 4 November 2014 GROFF(1)
|
|
@@ -348,17 +348,16 @@ USAGE
|
|
|
348
348
|
Yet, the easiest method involves the use of the application ttftot42(1). This program uses freetype(3) (ver‐
|
|
349
349
|
sion 1.3.1) to generate type42 font wrappers and well-formed AFM files that can be fed to the afmtodit(1)
|
|
350
350
|
script to create appropriate metric files. The resulting font wrappers should be added to the download file.
|
|
351
|
-
ttftot42
|
|
352
|
-
nih/ttftot42/⟩.
|
|
351
|
+
ttftot42 source code can be downloaded from ftp://www.giga.or.at/pub/nih/ttftot42/.
|
|
353
352
|
|
|
354
|
-
Another
|
|
355
|
-
|
|
353
|
+
Another solution for creating type42 wrappers is to use FontForge, available from http://fontforge.sf.net.
|
|
354
|
+
This font editor can convert most outline font formats.
|
|
356
355
|
|
|
357
356
|
FONT INSTALLATION
|
|
358
357
|
This section gives a summary of the above explanations; it can serve as a step-by-step font installation guide
|
|
359
358
|
for grops.
|
|
360
359
|
|
|
361
|
-
• Convert
|
|
360
|
+
• Convert your font to something groff understands. This is either a PostScript Type 1 font in PFA format
|
|
362
361
|
or a PostScript Type 42 font, together with an AFM file.
|
|
363
362
|
|
|
364
363
|
The very first characters in a PFA file look like this:
|
|
@@ -371,37 +370,37 @@ FONT INSTALLATION
|
|
|
371
370
|
|
|
372
371
|
%!PS-TrueTypeFont
|
|
373
372
|
|
|
374
|
-
This
|
|
373
|
+
This is a wrapper format for TrueType fonts. Old PS printers might not support it (this is, they don't
|
|
375
374
|
have a built-in TrueType font interpreter).
|
|
376
375
|
|
|
377
|
-
If
|
|
378
|
-
groff's
|
|
376
|
+
If your font is in PFB format (such fonts normally have ‘.pfb’ as the file extension), you might use
|
|
377
|
+
groff's pfbtops(1) program to convert it to PFA. For TrueType fonts, try ttftot42 or fontforge. For all
|
|
379
378
|
other font formats use fontforge which can convert most outline font formats.
|
|
380
379
|
|
|
381
380
|
• Convert the AFM file to a groff font description file with the afmtodit(1) program. An example call is
|
|
382
381
|
|
|
383
382
|
afmtodit Foo-Bar-Bold.afm textmap FBB
|
|
384
383
|
|
|
385
|
-
which
|
|
386
|
-
which
|
|
384
|
+
which converts the metric file ‘Foo-Bar-Bold.afm’ to the groff font ‘FBB’. If you have a font family
|
|
385
|
+
which comes with normal, bold, italic, and bold italic faces, it is recommended to use the letters R, B,
|
|
387
386
|
I, and BI, respectively, as postfixes in the groff font names to make groff's ‘.fam’ request work. An ex‐
|
|
388
|
-
ample
|
|
387
|
+
ample is groff's built-in Times-Roman font: The font family name is T, and the groff font names are TR,
|
|
389
388
|
TB, TI, and TBI.
|
|
390
389
|
|
|
391
|
-
• Install
|
|
392
|
-
which
|
|
390
|
+
• Install both the groff font description files and the fonts in a ‘devps’ subdirectory of the font path
|
|
391
|
+
which groff finds. See the ENVIRONMENT section in the troff(1) man page which lists the actual value of
|
|
393
392
|
the font path. Note that groff doesn't use the AFM files (but it is a good idea to store them anyway).
|
|
394
393
|
|
|
395
|
-
• Register
|
|
396
|
-
occurrence
|
|
397
|
-
file
|
|
398
|
-
assume
|
|
394
|
+
• Register all fonts which must be downloaded to the printer in the ‘devps/download’ file. Only the first
|
|
395
|
+
occurrence of this file in the font path is read. This means that you should copy the default ‘download’
|
|
396
|
+
file to the first directory in your font path and add your fonts there. To continue the above example we
|
|
397
|
+
assume that the PS font name for Foo-Bar-Bold.pfa is ‘XY-Foo-Bar-Bold’ (the PS font name is stored in the
|
|
399
398
|
internalname field in the ‘FBB’ file), thus the following line should be added to ’download’.
|
|
400
399
|
|
|
401
400
|
XY-Foo-Bar-Bold Foo-Bar-Bold.pfa
|
|
402
401
|
|
|
403
402
|
OLD FONTS
|
|
404
|
-
groff
|
|
403
|
+
groff versions 1.19.2 and earlier contain a slightly different set of the 35 Adobe core fonts; the difference
|
|
405
404
|
is mainly the lack of the ‘Euro’ glyph and a reduced set of kerning pairs. For backwards compatibility, these
|
|
406
405
|
old fonts are installed also in the
|
|
407
406
|
|
|
@@ -409,7 +408,7 @@ OLD FONTS
|
|
|
409
408
|
|
|
410
409
|
directory.
|
|
411
410
|
|
|
412
|
-
To
|
|
411
|
+
To use them, make sure that grops finds the fonts before the default system fonts (with the same names): Ei‐
|
|
413
412
|
ther add command line option -F to grops
|
|
414
413
|
|
|
415
414
|
groff -Tps -P-F -P/usr/share/groff/1.22.3/oldfont ...
|
|
@@ -420,11 +419,11 @@ OLD FONTS
|
|
|
420
419
|
|
|
421
420
|
ENVIRONMENT
|
|
422
421
|
GROPS_PROLOGUE
|
|
423
|
-
If
|
|
422
|
+
If this is set to foo, then grops uses the file foo (in the font path) instead of the default prologue
|
|
424
423
|
file prologue. The option -P overrides this environment variable.
|
|
425
424
|
|
|
426
425
|
GROFF_FONT_PATH
|
|
427
|
-
A
|
|
426
|
+
A list of directories in which to search for the devname directory in addition to the default ones.
|
|
428
427
|
See troff(1) and groff_font(5) for more details.
|
|
429
428
|
|
|
430
429
|
FILES
|
|
@@ -440,7 +439,7 @@ FILES
|
|
|
440
439
|
|
|
441
440
|
/usr/share/groff/1.22.3/tmac/pspic.tmac Definition of PSPIC macro, automatically loaded by ps.tmac.
|
|
442
441
|
|
|
443
|
-
/usr/share/groff/1.22.3/tmac/psold.tmac Macros
|
|
442
|
+
/usr/share/groff/1.22.3/tmac/psold.tmac Macros to disable use of characters not present in older Post‐
|
|
444
443
|
Script printers (e.g., ‘eth’ or ‘thorn’).
|
|
445
444
|
|
|
446
445
|
/tmp/gropsXXXXXX Temporary file. See groff(1) for details on the location of tem‐
|
|
@@ -449,8 +448,7 @@ FILES
|
|
|
449
448
|
SEE ALSO
|
|
450
449
|
afmtodit(1), groff(1), troff(1), pfbtops(1), groff_out(5), groff_font(5), groff_char(7), groff_tmac(5)
|
|
451
450
|
|
|
452
|
-
PostScript
|
|
453
|
-
developer/en/ps/5001.DSC_Spec.pdf⟩
|
|
451
|
+
PostScript Language Document Structuring Conventions Specification
|
|
454
452
|
|
|
455
453
|
COPYING
|
|
456
454
|
Copyright © 1989-2014 Free Software Foundation, Inc.
|
|
@@ -232,7 +232,6 @@ COPYING
|
|
|
232
232
|
source package.
|
|
233
233
|
|
|
234
234
|
AUTHORS
|
|
235
|
-
This file was originally written by James Clark, it was modified by
|
|
236
|
-
Warken ⟨groff-bernd.warken-72@web.de⟩.
|
|
235
|
+
This file was originally written by James Clark, it was modified by Werner Lemberg and Bernd Warken.
|
|
237
236
|
|
|
238
237
|
Groff Version 1.22.3 4 November 2014 TROFF(1)
|
|
@@ -16,7 +16,7 @@ SYNOPSIS
|
|
|
16
16
|
DESCRIPTION
|
|
17
17
|
This document describes the groff program, the main front-end for the groff document formatting system. The
|
|
18
18
|
groff program and macro suite is the implementation of a roff(7) system within the free software collection
|
|
19
|
-
GNU
|
|
19
|
+
GNU. The groff system has all features of the classical roff, but adds many extensions.
|
|
20
20
|
|
|
21
21
|
The groff program allows control of the whole groff system by command-line options. This is a great simplifi‐
|
|
22
22
|
cation in comparison to the classical case (which uses pipes only).
|
|
@@ -578,27 +578,25 @@ INSTALLATION DIRECTORIES
|
|
|
578
578
|
Font file for font F of device name.
|
|
579
579
|
|
|
580
580
|
AVAILABILITY
|
|
581
|
-
Information on how to get groff and related information is available at the groff
|
|
582
|
-
⟨http://www.gnu.org/software/groff⟩.
|
|
581
|
+
Information on how to get groff and related information is available at the groff page of the GNU website.
|
|
583
582
|
|
|
584
583
|
Three groff mailing lists are available:
|
|
585
584
|
|
|
586
|
-
bug tracker activity (read-only)
|
|
585
|
+
bug tracker activity (read-only);
|
|
587
586
|
|
|
588
|
-
general discussion
|
|
587
|
+
general discussion; and
|
|
589
588
|
|
|
590
|
-
commit activity (read-only)
|
|
591
|
-
itory by its developers.
|
|
589
|
+
commit activity (read-only), which reports changes to groff's source code repository by its developers.
|
|
592
590
|
|
|
593
|
-
Details
|
|
591
|
+
Details on repository access and much more can be found in the file README at the top directory of the groff
|
|
594
592
|
source package.
|
|
595
593
|
|
|
596
|
-
A
|
|
597
|
-
|
|
594
|
+
A free implementation of the grap preprocessor, written by Ted Faber, can be found at the grap website. This
|
|
595
|
+
is the only grap supported by groff.
|
|
598
596
|
|
|
599
597
|
AUTHORS
|
|
600
|
-
groff was written by James Clark
|
|
601
|
-
|
|
598
|
+
groff was written by James Clark. This document was rewritten, enhanced, and put under the FDL license in
|
|
599
|
+
2002 by Bernd Warken.
|
|
602
600
|
|
|
603
601
|
SEE ALSO
|
|
604
602
|
Groff: The GNU Implementation of troff, by Trent A. Fisher and Werner Lemberg, is the primary groff manual.
|
|
@@ -348,17 +348,16 @@ USAGE
|
|
|
348
348
|
Yet, the easiest method involves the use of the application ttftot42(1). This program uses freetype(3) (ver‐
|
|
349
349
|
sion 1.3.1) to generate type42 font wrappers and well-formed AFM files that can be fed to the afmtodit(1)
|
|
350
350
|
script to create appropriate metric files. The resulting font wrappers should be added to the download file.
|
|
351
|
-
ttftot42 source code can be downloaded from ftp://www.giga.or.at/pub/nih/ttftot42
|
|
352
|
-
nih/ttftot42/⟩.
|
|
351
|
+
ttftot42 source code can be downloaded from ftp://www.giga.or.at/pub/nih/ttftot42/.
|
|
353
352
|
|
|
354
|
-
Another
|
|
355
|
-
|
|
353
|
+
Another solution for creating type42 wrappers is to use FontForge, available from http://fontforge.sf.net.
|
|
354
|
+
This font editor can convert most outline font formats.
|
|
356
355
|
|
|
357
356
|
FONT INSTALLATION
|
|
358
357
|
This section gives a summary of the above explanations; it can serve as a step-by-step font installation guide
|
|
359
358
|
for grops.
|
|
360
359
|
|
|
361
|
-
• Convert
|
|
360
|
+
• Convert your font to something groff understands. This is either a PostScript Type 1 font in PFA format
|
|
362
361
|
or a PostScript Type 42 font, together with an AFM file.
|
|
363
362
|
|
|
364
363
|
The very first characters in a PFA file look like this:
|
|
@@ -371,37 +370,37 @@ FONT INSTALLATION
|
|
|
371
370
|
|
|
372
371
|
%!PS-TrueTypeFont
|
|
373
372
|
|
|
374
|
-
This
|
|
373
|
+
This is a wrapper format for TrueType fonts. Old PS printers might not support it (this is, they don't
|
|
375
374
|
have a built-in TrueType font interpreter).
|
|
376
375
|
|
|
377
376
|
If your font is in PFB format (such fonts normally have .pfb as the file extension), you might use groff's
|
|
378
|
-
pfbtops(1)
|
|
377
|
+
pfbtops(1) program to convert it to PFA. For TrueType fonts, try ttftot42 or fontforge. For all other
|
|
379
378
|
font formats use fontforge which can convert most outline font formats.
|
|
380
379
|
|
|
381
380
|
• Convert the AFM file to a groff font description file with the afmtodit(1) program. An example call is
|
|
382
381
|
|
|
383
382
|
afmtodit Foo-Bar-Bold.afm textmap FBB
|
|
384
383
|
|
|
385
|
-
which
|
|
386
|
-
comes
|
|
384
|
+
which converts the metric file Foo-Bar-Bold.afm to the groff font FBB. If you have a font family which
|
|
385
|
+
comes with normal, bold, italic, and bold italic faces, it is recommended to use the letters R, B, I, and
|
|
387
386
|
BI, respectively, as postfixes in the groff font names to make groff's ‘.fam’ request work. An example is
|
|
388
387
|
groff's built-in Times-Roman font: The font family name is T, and the groff font names are TR, TB, TI, and
|
|
389
388
|
TBI.
|
|
390
389
|
|
|
391
390
|
• Install both the groff font description files and the fonts in a devps subdirectory of the font path which
|
|
392
|
-
groff
|
|
391
|
+
groff finds. See section “Environment” in troff(1) for the actual value of the font path. Note that
|
|
393
392
|
groff doesn't use the AFM files (but it is a good idea to store them anyway).
|
|
394
393
|
|
|
395
394
|
• Register all fonts which must be downloaded to the printer in the devps/download file. Only the first oc‐
|
|
396
395
|
currence of this file in the font path is read. This means that you should copy the default download file
|
|
397
|
-
to
|
|
398
|
-
sume
|
|
396
|
+
to the first directory in your font path and add your fonts there. To continue the above example we as‐
|
|
397
|
+
sume that the PS font name for Foo-Bar-Bold.pfa is ‘XY-Foo-Bar-Bold’ (the PS font name is stored in the
|
|
399
398
|
internalname field in the FBB file), thus the following line should be added to download.
|
|
400
399
|
|
|
401
400
|
XY-Foo-Bar-Bold Foo-Bar-Bold.pfa
|
|
402
401
|
|
|
403
402
|
OLD FONTS
|
|
404
|
-
groff
|
|
403
|
+
groff versions 1.19.2 and earlier contain a slightly different set of the 35 Adobe core fonts; the difference
|
|
405
404
|
is mainly the lack of the ‘Euro’ glyph and a reduced set of kerning pairs. For backwards compatibility, these
|
|
406
405
|
old fonts are installed also in the
|
|
407
406
|
|
|
@@ -409,7 +408,7 @@ OLD FONTS
|
|
|
409
408
|
|
|
410
409
|
directory.
|
|
411
410
|
|
|
412
|
-
To
|
|
411
|
+
To use them, make sure that grops finds the fonts before the default system fonts (with the same names): Ei‐
|
|
413
412
|
ther add command-line option -F to grops
|
|
414
413
|
|
|
415
414
|
groff -Tps -P-F -P/usr/share/groff/1.22.4/oldfont ...
|
|
@@ -420,15 +419,15 @@ OLD FONTS
|
|
|
420
419
|
|
|
421
420
|
ENVIRONMENT
|
|
422
421
|
GROPS_PROLOGUE
|
|
423
|
-
If
|
|
422
|
+
If this is set to foo, then grops uses the file foo (in the font path) instead of the default prologue
|
|
424
423
|
file prologue. The option -P overrides this environment variable.
|
|
425
424
|
|
|
426
425
|
GROFF_FONT_PATH
|
|
427
|
-
A
|
|
426
|
+
A list of directories in which to search for the devname directory in addition to the default ones.
|
|
428
427
|
See troff(1) and groff_font(5) for more details.
|
|
429
428
|
|
|
430
429
|
SOURCE_DATE_EPOCH
|
|
431
|
-
A
|
|
430
|
+
A timestamp (expressed as seconds since the Unix epoch) to use as the creation timestamp in place of
|
|
432
431
|
the current time.
|
|
433
432
|
|
|
434
433
|
FILES
|
|
@@ -459,7 +458,6 @@ FILES
|
|
|
459
458
|
SEE ALSO
|
|
460
459
|
afmtodit(1), groff(1), troff(1), pfbtops(1), groff_out(5), groff_font(5), groff_char(7), groff_tmac(5)
|
|
461
460
|
|
|
462
|
-
PostScript
|
|
463
|
-
developer/en/ps/5001.DSC_Spec.pdf⟩
|
|
461
|
+
PostScript Language Document Structuring Conventions Specification
|
|
464
462
|
|
|
465
463
|
groff 1.22.4 11 October 2021 GROPS(1)
|
package/manpages/rhel9/pic.1.txt
CHANGED
|
@@ -403,14 +403,14 @@ SEE ALSO
|
|
|
403
403
|
|
|
404
404
|
Tpic: Pic for TeX
|
|
405
405
|
|
|
406
|
-
Brian W. Kernighan, PIC — A Graphics Language for Typesetting
|
|
407
|
-
|
|
406
|
+
Brian W. Kernighan, PIC — A Graphics Language for Typesetting (User Manual). AT&T Bell Laboratories, Comput‐
|
|
407
|
+
ing Science Technical Report No. 116 (revised May, 1991).
|
|
408
408
|
|
|
409
|
-
ps2eps is available from CTAN mirrors, e.g.
|
|
409
|
+
ps2eps is available from CTAN mirrors, e.g. ftp://ftp.dante.de/tex-archive/support/ps2eps/
|
|
410
410
|
|
|
411
|
-
W. Richard Stevens, Turning PIC into HTML
|
|
411
|
+
W. Richard Stevens, Turning PIC into HTML
|
|
412
412
|
|
|
413
|
-
W. Richard Stevens, Examples of pic Macros
|
|
413
|
+
W. Richard Stevens, Examples of pic Macros
|
|
414
414
|
|
|
415
415
|
BUGS
|
|
416
416
|
Input characters that are invalid for groff (i.e., those with ASCII code 0, or 013 octal, or between 015 and
|
|
@@ -205,7 +205,7 @@ FILES
|
|
|
205
205
|
|
|
206
206
|
AUTHORS
|
|
207
207
|
The GNU version of troff was originally written by James Clark; he also wrote the original version of this
|
|
208
|
-
document, which was modified by Werner Lemberg
|
|
208
|
+
document, which was modified by Werner Lemberg and Bernd Warken.
|
|
209
209
|
|
|
210
210
|
SEE ALSO
|
|
211
211
|
groff(1)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-redhat-manpage-data",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Pre-extracted RHEL man pages for mcp-redhat-manpage (RHEL 8, 9, 10)",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"scripts": {
|
|
@@ -21,5 +21,9 @@
|
|
|
21
21
|
"homepage": "https://github.com/shonstephens/mcp-redhat-manpage-data#readme",
|
|
22
22
|
"bugs": {
|
|
23
23
|
"url": "https://github.com/shonstephens/mcp-redhat-manpage-data/issues"
|
|
24
|
+
},
|
|
25
|
+
"publishConfig": {
|
|
26
|
+
"provenance": true,
|
|
27
|
+
"access": "public"
|
|
24
28
|
}
|
|
25
29
|
}
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
K5IDENTITY(5) MIT Kerberos K5IDENTITY(5)
|
|
2
|
-
|
|
3
|
-
NAME
|
|
4
|
-
k5identity - Kerberos V5 client principal selection rules
|
|
5
|
-
|
|
6
|
-
DESCRIPTION
|
|
7
|
-
The .k5identity file, which resides in a user's home directory, contains a list of rules for selecting a
|
|
8
|
-
client principals based on the server being accessed. These rules are used to choose a credential cache
|
|
9
|
-
within the cache collection when possible.
|
|
10
|
-
|
|
11
|
-
Blank lines and lines beginning with # are ignored. Each line has the form:
|
|
12
|
-
principal field=value ...
|
|
13
|
-
|
|
14
|
-
If the server principal meets all of the field constraints, then principal is chosen as the client principal.
|
|
15
|
-
The following fields are recognized:
|
|
16
|
-
|
|
17
|
-
realm If the realm of the server principal is known, it is matched against value, which may be a pattern us‐
|
|
18
|
-
ing shell wildcards. For host-based server principals, the realm will generally only be known if there
|
|
19
|
-
is a [domain_realm] section in krb5.conf with a mapping for the hostname.
|
|
20
|
-
|
|
21
|
-
service
|
|
22
|
-
If the server principal is a host-based principal, its service component is matched against value,
|
|
23
|
-
which may be a pattern using shell wildcards.
|
|
24
|
-
|
|
25
|
-
host If the server principal is a host-based principal, its hostname component is converted to lower case
|
|
26
|
-
and matched against value, which may be a pattern using shell wildcards.
|
|
27
|
-
|
|
28
|
-
If the server principal matches the constraints of multiple lines in the .k5identity file, the princi‐
|
|
29
|
-
pal from the first matching line is used. If no line matches, credentials will be selected some other
|
|
30
|
-
way, such as the realm heuristic or the current primary cache.
|
|
31
|
-
|
|
32
|
-
EXAMPLE
|
|
33
|
-
The following example .k5identity file selects the client principal alice@KRBTEST.COM if the server principal
|
|
34
|
-
is within that realm, the principal alice/root@EXAMPLE.COM if the server host is within a servers subdomain,
|
|
35
|
-
and the principal alice/mail@EXAMPLE.COM when accessing the IMAP service on mail.example.com:
|
|
36
|
-
|
|
37
|
-
alice@KRBTEST.COM realm=KRBTEST.COM
|
|
38
|
-
alice/root@EXAMPLE.COM host=*.servers.example.com
|
|
39
|
-
alice/mail@EXAMPLE.COM host=mail.example.com service=imap
|
|
40
|
-
|
|
41
|
-
SEE ALSO
|
|
42
|
-
kerberos(1), krb5.conf
|
|
43
|
-
|
|
44
|
-
AUTHOR
|
|
45
|
-
MIT
|
|
46
|
-
|
|
47
|
-
COPYRIGHT
|
|
48
|
-
1985-2025, MIT
|
|
49
|
-
|
|
50
|
-
1.21.3 K5IDENTITY(5)
|
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
K5LOGIN(5) MIT Kerberos K5LOGIN(5)
|
|
2
|
-
|
|
3
|
-
NAME
|
|
4
|
-
k5login - Kerberos V5 acl file for host access
|
|
5
|
-
|
|
6
|
-
DESCRIPTION
|
|
7
|
-
The .k5login file, which resides in a user's home directory, contains a list of the Kerberos principals. Any‐
|
|
8
|
-
one with valid tickets for a principal in the file is allowed host access with the UID of the user in whose
|
|
9
|
-
home directory the file resides. One common use is to place a .k5login file in root's home directory, thereby
|
|
10
|
-
granting system administrators remote root access to the host via Kerberos.
|
|
11
|
-
|
|
12
|
-
EXAMPLES
|
|
13
|
-
Suppose the user alice had a .k5login file in her home directory containing just the following line:
|
|
14
|
-
|
|
15
|
-
bob@FOOBAR.ORG
|
|
16
|
-
|
|
17
|
-
This would allow bob to use Kerberos network applications, such as ssh(1), to access alice's account, using
|
|
18
|
-
bob's Kerberos tickets. In a default configuration (with k5login_authoritative set to true in krb5.conf),
|
|
19
|
-
this .k5login file would not let alice use those network applications to access her account, since she is not
|
|
20
|
-
listed! With no .k5login file, or with k5login_authoritative set to false, a default rule would permit the
|
|
21
|
-
principal alice in the machine's default realm to access the alice account.
|
|
22
|
-
|
|
23
|
-
Let us further suppose that alice is a system administrator. Alice and the other system administrators would
|
|
24
|
-
have their principals in root's .k5login file on each host:
|
|
25
|
-
|
|
26
|
-
alice@BLEEP.COM
|
|
27
|
-
|
|
28
|
-
joeadmin/root@BLEEP.COM
|
|
29
|
-
|
|
30
|
-
This would allow either system administrator to log in to these hosts using their Kerberos tickets instead of
|
|
31
|
-
having to type the root password. Note that because bob retains the Kerberos tickets for his own principal,
|
|
32
|
-
bob@FOOBAR.ORG, he would not have any of the privileges that require alice's tickets, such as root access to
|
|
33
|
-
any of the site's hosts, or the ability to change alice's password.
|
|
34
|
-
|
|
35
|
-
SEE ALSO
|
|
36
|
-
kerberos(1)
|
|
37
|
-
|
|
38
|
-
AUTHOR
|
|
39
|
-
MIT
|
|
40
|
-
|
|
41
|
-
COPYRIGHT
|
|
42
|
-
1985-2025, MIT
|
|
43
|
-
|
|
44
|
-
1.21.3 K5LOGIN(5)
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
K5IDENTITY(5) MIT Kerberos K5IDENTITY(5)
|
|
2
|
-
|
|
3
|
-
NAME
|
|
4
|
-
k5identity - Kerberos V5 client principal selection rules
|
|
5
|
-
|
|
6
|
-
DESCRIPTION
|
|
7
|
-
The .k5identity file, which resides in a user's home directory, contains a list of rules for selecting a
|
|
8
|
-
client principals based on the server being accessed. These rules are used to choose a credential cache
|
|
9
|
-
within the cache collection when possible.
|
|
10
|
-
|
|
11
|
-
Blank lines and lines beginning with # are ignored. Each line has the form:
|
|
12
|
-
principal field=value ...
|
|
13
|
-
|
|
14
|
-
If the server principal meets all of the field constraints, then principal is chosen as the client principal.
|
|
15
|
-
The following fields are recognized:
|
|
16
|
-
|
|
17
|
-
realm If the realm of the server principal is known, it is matched against value, which may be a pattern us‐
|
|
18
|
-
ing shell wildcards. For host-based server principals, the realm will generally only be known if there
|
|
19
|
-
is a [domain_realm] section in krb5.conf with a mapping for the hostname.
|
|
20
|
-
|
|
21
|
-
service
|
|
22
|
-
If the server principal is a host-based principal, its service component is matched against value,
|
|
23
|
-
which may be a pattern using shell wildcards.
|
|
24
|
-
|
|
25
|
-
host If the server principal is a host-based principal, its hostname component is converted to lower case
|
|
26
|
-
and matched against value, which may be a pattern using shell wildcards.
|
|
27
|
-
|
|
28
|
-
If the server principal matches the constraints of multiple lines in the .k5identity file, the princi‐
|
|
29
|
-
pal from the first matching line is used. If no line matches, credentials will be selected some other
|
|
30
|
-
way, such as the realm heuristic or the current primary cache.
|
|
31
|
-
|
|
32
|
-
EXAMPLE
|
|
33
|
-
The following example .k5identity file selects the client principal alice@KRBTEST.COM if the server principal
|
|
34
|
-
is within that realm, the principal alice/root@EXAMPLE.COM if the server host is within a servers subdomain,
|
|
35
|
-
and the principal alice/mail@EXAMPLE.COM when accessing the IMAP service on mail.example.com:
|
|
36
|
-
|
|
37
|
-
alice@KRBTEST.COM realm=KRBTEST.COM
|
|
38
|
-
alice/root@EXAMPLE.COM host=*.servers.example.com
|
|
39
|
-
alice/mail@EXAMPLE.COM host=mail.example.com service=imap
|
|
40
|
-
|
|
41
|
-
SEE ALSO
|
|
42
|
-
kerberos(1), krb5.conf
|
|
43
|
-
|
|
44
|
-
AUTHOR
|
|
45
|
-
MIT
|
|
46
|
-
|
|
47
|
-
COPYRIGHT
|
|
48
|
-
1985-2025, MIT
|
|
49
|
-
|
|
50
|
-
1.21.3 K5IDENTITY(5)
|
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
K5LOGIN(5) MIT Kerberos K5LOGIN(5)
|
|
2
|
-
|
|
3
|
-
NAME
|
|
4
|
-
k5login - Kerberos V5 acl file for host access
|
|
5
|
-
|
|
6
|
-
DESCRIPTION
|
|
7
|
-
The .k5login file, which resides in a user's home directory, contains a list of the Kerberos principals. Any‐
|
|
8
|
-
one with valid tickets for a principal in the file is allowed host access with the UID of the user in whose
|
|
9
|
-
home directory the file resides. One common use is to place a .k5login file in root's home directory, thereby
|
|
10
|
-
granting system administrators remote root access to the host via Kerberos.
|
|
11
|
-
|
|
12
|
-
EXAMPLES
|
|
13
|
-
Suppose the user alice had a .k5login file in her home directory containing just the following line:
|
|
14
|
-
|
|
15
|
-
bob@FOOBAR.ORG
|
|
16
|
-
|
|
17
|
-
This would allow bob to use Kerberos network applications, such as ssh(1), to access alice's account, using
|
|
18
|
-
bob's Kerberos tickets. In a default configuration (with k5login_authoritative set to true in krb5.conf),
|
|
19
|
-
this .k5login file would not let alice use those network applications to access her account, since she is not
|
|
20
|
-
listed! With no .k5login file, or with k5login_authoritative set to false, a default rule would permit the
|
|
21
|
-
principal alice in the machine's default realm to access the alice account.
|
|
22
|
-
|
|
23
|
-
Let us further suppose that alice is a system administrator. Alice and the other system administrators would
|
|
24
|
-
have their principals in root's .k5login file on each host:
|
|
25
|
-
|
|
26
|
-
alice@BLEEP.COM
|
|
27
|
-
|
|
28
|
-
joeadmin/root@BLEEP.COM
|
|
29
|
-
|
|
30
|
-
This would allow either system administrator to log in to these hosts using their Kerberos tickets instead of
|
|
31
|
-
having to type the root password. Note that because bob retains the Kerberos tickets for his own principal,
|
|
32
|
-
bob@FOOBAR.ORG, he would not have any of the privileges that require alice's tickets, such as root access to
|
|
33
|
-
any of the site's hosts, or the ability to change alice's password.
|
|
34
|
-
|
|
35
|
-
SEE ALSO
|
|
36
|
-
kerberos(1)
|
|
37
|
-
|
|
38
|
-
AUTHOR
|
|
39
|
-
MIT
|
|
40
|
-
|
|
41
|
-
COPYRIGHT
|
|
42
|
-
1985-2025, MIT
|
|
43
|
-
|
|
44
|
-
1.21.3 K5LOGIN(5)
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
K5IDENTITY(5) MIT Kerberos K5IDENTITY(5)
|
|
2
|
-
|
|
3
|
-
NAME
|
|
4
|
-
k5identity - Kerberos V5 client principal selection rules
|
|
5
|
-
|
|
6
|
-
DESCRIPTION
|
|
7
|
-
The .k5identity file, which resides in a user's home directory, contains a list of rules for selecting a
|
|
8
|
-
client principals based on the server being accessed. These rules are used to choose a credential cache
|
|
9
|
-
within the cache collection when possible.
|
|
10
|
-
|
|
11
|
-
Blank lines and lines beginning with # are ignored. Each line has the form:
|
|
12
|
-
principal field=value ...
|
|
13
|
-
|
|
14
|
-
If the server principal meets all of the field constraints, then principal is chosen as the client principal.
|
|
15
|
-
The following fields are recognized:
|
|
16
|
-
|
|
17
|
-
realm If the realm of the server principal is known, it is matched against value, which may be a pattern us‐
|
|
18
|
-
ing shell wildcards. For host-based server principals, the realm will generally only be known if there
|
|
19
|
-
is a [domain_realm] section in krb5.conf with a mapping for the hostname.
|
|
20
|
-
|
|
21
|
-
service
|
|
22
|
-
If the server principal is a host-based principal, its service component is matched against value,
|
|
23
|
-
which may be a pattern using shell wildcards.
|
|
24
|
-
|
|
25
|
-
host If the server principal is a host-based principal, its hostname component is converted to lower case
|
|
26
|
-
and matched against value, which may be a pattern using shell wildcards.
|
|
27
|
-
|
|
28
|
-
If the server principal matches the constraints of multiple lines in the .k5identity file, the princi‐
|
|
29
|
-
pal from the first matching line is used. If no line matches, credentials will be selected some other
|
|
30
|
-
way, such as the realm heuristic or the current primary cache.
|
|
31
|
-
|
|
32
|
-
EXAMPLE
|
|
33
|
-
The following example .k5identity file selects the client principal alice@KRBTEST.COM if the server principal
|
|
34
|
-
is within that realm, the principal alice/root@EXAMPLE.COM if the server host is within a servers subdomain,
|
|
35
|
-
and the principal alice/mail@EXAMPLE.COM when accessing the IMAP service on mail.example.com:
|
|
36
|
-
|
|
37
|
-
alice@KRBTEST.COM realm=KRBTEST.COM
|
|
38
|
-
alice/root@EXAMPLE.COM host=*.servers.example.com
|
|
39
|
-
alice/mail@EXAMPLE.COM host=mail.example.com service=imap
|
|
40
|
-
|
|
41
|
-
SEE ALSO
|
|
42
|
-
kerberos(1), krb5.conf
|
|
43
|
-
|
|
44
|
-
AUTHOR
|
|
45
|
-
MIT
|
|
46
|
-
|
|
47
|
-
COPYRIGHT
|
|
48
|
-
1985-2025, MIT
|
|
49
|
-
|
|
50
|
-
1.21.3 K5IDENTITY(5)
|
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
K5LOGIN(5) MIT Kerberos K5LOGIN(5)
|
|
2
|
-
|
|
3
|
-
NAME
|
|
4
|
-
k5login - Kerberos V5 acl file for host access
|
|
5
|
-
|
|
6
|
-
DESCRIPTION
|
|
7
|
-
The .k5login file, which resides in a user's home directory, contains a list of the Kerberos principals. Any‐
|
|
8
|
-
one with valid tickets for a principal in the file is allowed host access with the UID of the user in whose
|
|
9
|
-
home directory the file resides. One common use is to place a .k5login file in root's home directory, thereby
|
|
10
|
-
granting system administrators remote root access to the host via Kerberos.
|
|
11
|
-
|
|
12
|
-
EXAMPLES
|
|
13
|
-
Suppose the user alice had a .k5login file in her home directory containing just the following line:
|
|
14
|
-
|
|
15
|
-
bob@FOOBAR.ORG
|
|
16
|
-
|
|
17
|
-
This would allow bob to use Kerberos network applications, such as ssh(1), to access alice's account, using
|
|
18
|
-
bob's Kerberos tickets. In a default configuration (with k5login_authoritative set to true in krb5.conf),
|
|
19
|
-
this .k5login file would not let alice use those network applications to access her account, since she is not
|
|
20
|
-
listed! With no .k5login file, or with k5login_authoritative set to false, a default rule would permit the
|
|
21
|
-
principal alice in the machine's default realm to access the alice account.
|
|
22
|
-
|
|
23
|
-
Let us further suppose that alice is a system administrator. Alice and the other system administrators would
|
|
24
|
-
have their principals in root's .k5login file on each host:
|
|
25
|
-
|
|
26
|
-
alice@BLEEP.COM
|
|
27
|
-
|
|
28
|
-
joeadmin/root@BLEEP.COM
|
|
29
|
-
|
|
30
|
-
This would allow either system administrator to log in to these hosts using their Kerberos tickets instead of
|
|
31
|
-
having to type the root password. Note that because bob retains the Kerberos tickets for his own principal,
|
|
32
|
-
bob@FOOBAR.ORG, he would not have any of the privileges that require alice's tickets, such as root access to
|
|
33
|
-
any of the site's hosts, or the ability to change alice's password.
|
|
34
|
-
|
|
35
|
-
SEE ALSO
|
|
36
|
-
kerberos(1)
|
|
37
|
-
|
|
38
|
-
AUTHOR
|
|
39
|
-
MIT
|
|
40
|
-
|
|
41
|
-
COPYRIGHT
|
|
42
|
-
1985-2025, MIT
|
|
43
|
-
|
|
44
|
-
1.21.3 K5LOGIN(5)
|