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.
@@ -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: '20'
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: Bump version and publish
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
- npm version patch -m "Update man pages from latest UBI images"
53
- npm publish
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 HTML manual ⟨file:///usr/share/doc/groff/html/mom/toc.html⟩ for extensive documenta‐
334
- tion. She—for mom takes the female pronoun—can be specified on the command line as -mom.
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 ⟨http://www.gnu.org/software/groff⟩.
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 ⟨faber@lunabase.org⟩, can be found at the
640
- grap website ⟨http://www.lunabase.org/~faber/Vault/software/grap/⟩. groff supports only this grap.
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 the front-end command and the overall system) was primarily written by James Clark ⟨jjc@jclark
644
- .com⟩. Contributors to this document include Clark, Trent A. Fisher, Werner Lemberg ⟨wl@gnu.org⟩, Bernd
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: The GNU Implementation of troff, by Trent A. Fisher and Werner Lemberg, is the primary groff manual.
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), eqn(1), neqn(1), glilypond(1), grn(1), preconv(1), gperl(1), pic(1), gpinyin(1), refer(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), groff_man(7), groff_man_style(7), groff_mdoc(7), groff_me(7), groff_mm(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 ⟨https://fontforge.org/⟩, a font editor that can convert most outline font
320
- formats. Here's an example of using the Roboto Slab Serif font with groff. Several variables are used so
321
- that you can more easily adapt it into your own script.
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 and afmtodit may generate warnings depending on the attributes of the font. The test procedure is
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 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‐
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 PFB file contains this string as well, preceded by some non-printing bytes. If your font is in PFB for‐
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 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 ⟨https://ctan.org/tex-archive/fonts/brushscr⟩ font in PFA format.
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 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
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 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
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 fonts in the devps/download file so they can be located for embedding in PostScript files grops
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 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‐
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 use them, make sure that grops finds the fonts before the default system fonts (with the same names): ei‐
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 list of directories in which to seek the selected output device's directory of device and font de‐
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 this is set to foo, then grops uses the file foo (in the font path) instead of the default prologue
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 timestamp (expressed as seconds since the Unix epoch) to use as the output creation timestamp in
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 the encoding scheme used by most PostScript Type 1 fonts; the encoding directive of font de‐
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 macros for use with the ps output device. It is automatically loaded by troffrc when the ps
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 the PSPIC macro for embedding images in a document; see groff_tmac(5). It is automatically
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 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
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 creates temporary files using the template “gropsXXXXXX”; see groff(1) for details on their storage lo‐
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 Language Document Structuring Conventions Specification ⟨http://partners.adobe.com/public/
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
- http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-048.pdf⟩.
191
+ http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-048.pdf.
192
192
 
193
- “Hyperlinks in Terminal Emulators” ⟨https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda⟩,
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., ftp://ftp.dante.de/tex-archive/support/ps2eps/⟩
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 ⟨http://www.kohala.com/start/troff/pic2html.html⟩
400
+ W. Richard Stevens, Turning PIC into HTML
401
401
 
402
- W. Richard Stevens, Examples of pic Macros ⟨http://www.kohala.com/start/troff/pic.examples.ps⟩
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 spanning example above was taken from mandoc's man page for its tbl implementation
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, which was updated by Werner Lemberg ⟨wl@gnu.org⟩, Bernd Warken ⟨groff-bernd.warken-72@web.de⟩, and
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: The GNU Implementation of troff, by Trent A. Fisher and Werner Lemberg, is the primary groff manual.
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 the syntax of groff special character escape sequences, and lists all special characters pre‐
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 ⟨http://www.gnu.org⟩. The groff system has all features of the classical roff, but adds many extensions.
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 the groff mailing list ⟨bug-groff@gnu.org⟩. Include a complete, self-contained example that
497
- allows the bug to be reproduced, and say which version of groff you are using.
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 on how to get groff and related information is available at the groff GNU website ⟨http://
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 ⟨bug-groff@gnu.org⟩.
590
+ for reporting bugs.
592
591
 
593
- for general discussion of groff, ⟨groff@gnu.org⟩.
592
+ for general discussion of groff,.
594
593
 
595
- the groff commit list ⟨groff-commit@ffii.org⟩, a read-only list showing logs of commitments to the
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 ⟨faber@lunabase.org⟩. The ac‐
602
- tual version can be found at the grap website ⟨http://www.lunabase.org/~faber/Vault/software/grap/⟩. This is
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), groff_man(7), groff_mdoc(7), groff_me(7), groff_mm(7), groff_mmse(7), groff_mom(7),
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), afmtodit(1), eqn2graph(1), gdiffmk(1), grap2graph(1), groffer(1), gxditview(1),
649
- hpftodit(1), indxbib(1), lkbib(1), lookbib(1), pdfroff(1), pfbtops(1), pic2graph(1), tfmtodit(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 copy of the Free Documentation License is included as a file called FDL in the main directory of the groff
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 ⟨http://www.gnu.org/copyleft/fdl.html⟩.
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 ⟨jjc@jclark.com⟩. It was rewrit‐
670
- ten, enhanced, and put under the FDL license by Bernd Warken <groff-bernd.warken-72@web.de>. It is maintained
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 source code can be downloaded from ftp://www.giga.or.at/pub/nih/ttftot42/ ⟨ftp://www.giga.or.at/pub/
352
- nih/ttftot42/⟩.
351
+ ttftot42 source code can be downloaded from ftp://www.giga.or.at/pub/nih/ttftot42/.
353
352
 
354
- Another solution for creating type42 wrappers is to use FontForge, available from http://fontforge.sf.net
355
- ⟨http://fontforge.sf.net⟩. This font editor can convert most outline font formats.
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 your font to something groff understands. This is either a PostScript Type 1 font in PFA format
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 is a wrapper format for TrueType fonts. Old PS printers might not support it (this is, they don't
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 your font is in PFB format (such fonts normally have ‘.pfb’ as the file extension), you might use
378
- groff's pfbtops(1) program to convert it to PFA. For TrueType fonts, try ttftot42 or fontforge. For all
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 converts the metric file ‘Foo-Bar-Bold.afm’ to the groff font ‘FBB’. If you have a font family
386
- which comes with normal, bold, italic, and bold italic faces, it is recommended to use the letters R, B,
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 is groff's built-in Times-Roman font: The font family name is T, and the groff font names are TR,
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 both the groff font description files and the fonts in a ‘devps’ subdirectory of the font path
392
- which groff finds. See the ENVIRONMENT section in the troff(1) man page which lists the actual value of
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 all fonts which must be downloaded to the printer in the ‘devps/download’ file. Only the first
396
- occurrence of this file in the font path is read. This means that you should copy the default ‘download’
397
- file to the first directory in your font path and add your fonts there. To continue the above example we
398
- assume that the PS font name for Foo-Bar-Bold.pfa is ‘XY-Foo-Bar-Bold’ (the PS font name is stored in the
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 versions 1.19.2 and earlier contain a slightly different set of the 35 Adobe core fonts; the difference
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 use them, make sure that grops finds the fonts before the default system fonts (with the same names): Ei‐
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 this is set to foo, then grops uses the file foo (in the font path) instead of the default prologue
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 list of directories in which to search for the devname directory in addition to the default ones.
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 to disable use of characters not present in older Post‐
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 Language Document Structuring Conventions Specification ⟨http://partners.adobe.com/public/
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 Werner Lemberg ⟨wl@gnu.org⟩ and Bernd
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 ⟨http://www.gnu.org⟩. The groff system has all features of the classical roff, but adds many extensions.
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 page of the GNU website
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) ⟨bug-groff@gnu.org⟩;
585
+ bug tracker activity (read-only);
587
586
 
588
- general discussion ⟨groff@gnu.org⟩; and
587
+ general discussion; and
589
588
 
590
- commit activity (read-only) ⟨groff-commit@gnu.org⟩, which reports changes to groff's source code repos‐
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 on repository access and much more can be found in the file README at the top directory of the groff
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 free implementation of the grap preprocessor, written by Ted Faber ⟨faber@lunabase.org⟩, can be found at the
597
- grap website ⟨http://www.lunabase.org/~faber/Vault/software/grap/⟩. This is the only grap supported by groff.
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 ⟨jjc@jclark.com⟩. This document was rewritten, enhanced, and put under the
601
- FDL license in 2002 by Bernd Warken ⟨groff-bernd.warken-72@web.de⟩.
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/ ⟨ftp://www.giga.or.at/pub/
352
- nih/ttftot42/⟩.
351
+ ttftot42 source code can be downloaded from ftp://www.giga.or.at/pub/nih/ttftot42/.
353
352
 
354
- Another solution for creating type42 wrappers is to use FontForge, available from http://fontforge.sf.net
355
- ⟨http://fontforge.sf.net⟩. This font editor can convert most outline font formats.
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 your font to something groff understands. This is either a PostScript Type 1 font in PFA format
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 is a wrapper format for TrueType fonts. Old PS printers might not support it (this is, they don't
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) program to convert it to PFA. For TrueType fonts, try ttftot42 or fontforge. For all other
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 converts the metric file Foo-Bar-Bold.afm to the groff font FBB. If you have a font family which
386
- comes with normal, bold, italic, and bold italic faces, it is recommended to use the letters R, B, I, and
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 finds. See section “Environment” in troff(1) for the actual value of the font path. Note that
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 the first directory in your font path and add your fonts there. To continue the above example we as‐
398
- sume that the PS font name for Foo-Bar-Bold.pfa is ‘XY-Foo-Bar-Bold’ (the PS font name is stored in the
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 versions 1.19.2 and earlier contain a slightly different set of the 35 Adobe core fonts; the difference
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 use them, make sure that grops finds the fonts before the default system fonts (with the same names): Ei‐
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 this is set to foo, then grops uses the file foo (in the font path) instead of the default prologue
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 list of directories in which to search for the devname directory in addition to the default ones.
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 timestamp (expressed as seconds since the Unix epoch) to use as the creation timestamp in place of
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 Language Document Structuring Conventions Specification ⟨http://partners.adobe.com/public/
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)
@@ -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 (User Manual) ⟨http://cm.bell-labs.com/cm/cs/
407
- cstr/116.ps.gz⟩. AT&T Bell Laboratories, Computing Science Technical Report No. 116 (revised May, 1991).
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. ftp://ftp.dante.de/tex-archive/support/ps2eps/⟩
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 ⟨http://www.kohala.com/start/troff/pic2html.html⟩
411
+ W. Richard Stevens, Turning PIC into HTML
412
412
 
413
- W. Richard Stevens, Examples of pic Macros ⟨http://www.kohala.com/start/troff/pic.examples.ps⟩
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 ⟨wl@gnu.org⟩ and Bernd Warken ⟨groff-bernd.warken-72@web.de⟩.
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.0",
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)