/crypto/heimdal/kuser/copy_cred_cache.1

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 96 lines · 96 code · 0 blank · 0 comment · 0 complexity · 1d27dbae099f585496f9e7c8692effa3 MD5 · raw file 

    

  1. .\" Copyright (c) 2004 Kungliga Tekniska Hรถgskolan
    2. 

  2. .\" (Royal Institute of Technology, Stockholm, Sweden).
    3. 

  3. .\" All rights reserved.
    4. 

  4. .\"
    5. 

  5. .\" Redistribution and use in source and binary forms, with or without
    6. 

  6. .\" modification, are permitted provided that the following conditions
    7. 

  7. .\" are met:
    8. 

  8. .\"
    9. 

  9. .\" 1. Redistributions of source code must retain the above copyright
    10. 

  10. .\"    notice, this list of conditions and the following disclaimer.
    11. 

  11. .\"
    12. 

  12. .\" 2. Redistributions in binary form must reproduce the above copyright
    13. 

  13. .\"    notice, this list of conditions and the following disclaimer in the
    14. 

  14. .\"    documentation and/or other materials provided with the distribution.
    15. 

  15. .\"
    16. 

  16. .\" 3. Neither the name of the Institute nor the names of its contributors
    17. 

  17. .\"    may be used to endorse or promote products derived from this software
    18. 

  18. .\"    without specific prior written permission.
    19. 

  19. .\"
    20. 

  20. .\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
    21. 

  21. .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    22. 

  22. .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    23. 

  23. .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
    24. 

  24. .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    25. 

  25. .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
    26. 

  26. .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
    27. 

  27. .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
    28. 

  28. .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
    29. 

  29. .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    30. 

  30. .\" SUCH DAMAGE.
    31. 

  31. .\"
    32. 

  32. .\" $Id$
    33. 

  33. .\"
    34. 

  34. .Dd April 24, 2004
    35. 

  35. .Dt COPY_CRED_CACHE 1
    36. 

  36. .Os HEIMDAL
    37. 

  37. .Sh NAME
    38. 

  38. .Nm copy_cred_cache
    39. 

  39. .Nd copy credentials from one cache to another
    40. 

  40. .Sh SYNOPSIS
    41. 

  41. .Nm
    42. 

  42. .Op Fl Fl krbtgt-only
    43. 

  43. .Op Fl Fl service= Ns Ar principal
    44. 

  44. .Op Fl Fl enctype= Ns Ar enctype
    45. 

  45. .Op Fl Fl flags= Ns Ar ticketflags
    46. 

  46. .Op Fl Fl valid-for= Ns Ar time
    47. 

  47. .Op Fl Fl fcache-version= Ns Ar integer
    48. 

  48. .Op Aq Ar from-cache
    49. 

  49. .Aq Ar to-cache
    50. 

  50. .Sh DESCRIPTION
    51. 

  51. .Nm
    52. 

  52. copies credentials from
    53. 

  53. .Aq Ar from-cache
    54. 

  54. (or the default cache) to
    55. 

  55. .Aq Ar to-cache .
    56. 

  56. .Pp
    57. 

  57. Supported options:
    58. 

  58. .Bl -tag -width Ds
    59. 

  59. .It Fl Fl krbtgt-only
    60. 

  60. Copies only krbtgt credentials for the client's realm. This is
    61. 

  61. equivalent to
    62. 

  62. .Fl Fl service= Ns Li krbtgt/ Ns Ao Ar CLIENTREALM Ac Ns Li @ Ns Ao Ar CLIENTREALM Ac .
    63. 

  63. .It Fl Fl service= Ns Ar principal
    64. 

  64. Copies only credentials matching this service principal.
    65. 

  65. .It Fl Fl enctype= Ns Ar enctype
    66. 

  66. Copies only credentials a matching enctype.
    67. 

  67. .It Fl Fl flags= Ns Ar ticketflags
    68. 

  68. Copies only credentials with these ticket flags set.
    69. 

  69. .It Fl Fl valid-for= Ns Ar time
    70. 

  70. Copies only credentials that are valid for at least this long. This
    71. 

  71. does not take renewable creds into account.
    72. 

  72. .It Fl Fl fcache-version= Ns Ar integer
    73. 

  73. The created cache, If a standard
    74. 

  74. .Li FILE
    75. 

  75. cache is created, it will have this file format version.
    76. 

  76. .El
    77. 

  77. .\".Sh ENVIRONMENT
    78. 

  78. .\".Sh FILES
    79. 

  79. .Sh EXAMPLES
    80. 

  80. To copy only credentials that are valid for at least one day and with
    81. 

  81. the
    82. 

  82. .Li initial
    83. 

  83. flag set, try something like:
    84. 

  84. .Bd -literal -offset indent
    85. 

  85. $ copy_cred_cache --valid-for=1d --flags=initial FILE:/some/cache
    86. 

  86. .Ed
    87. 

  87. .Sh DIAGNOSTICS
    88. 

  88. The
    89. 

  89. .Nm
    90. 

  90. utility exits 0 on success, and \*[Gt]0 if an error occurs, or if no
    91. 

  91. credentials where actually copied.
    92. 

  92. .\".Sh SEE ALSO
    93. 

  93. .\".Sh STANDARDS
    94. 

  94. .\".Sh HISTORY
    95. 

  95. .\".Sh AUTHORS
    96. 

  96. .\".Sh BUGS
    97.