mirror of
				https://github.com/optim-enterprises-bv/vault.git
				synced 2025-11-04 12:37:59 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			77 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			77 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
package command
 | 
						|
 | 
						|
import (
 | 
						|
	"fmt"
 | 
						|
	"strings"
 | 
						|
 | 
						|
	"github.com/hashicorp/vault/meta"
 | 
						|
)
 | 
						|
 | 
						|
// PathHelpCommand is a Command that lists the mounts.
 | 
						|
type PathHelpCommand struct {
 | 
						|
	meta.Meta
 | 
						|
}
 | 
						|
 | 
						|
func (c *PathHelpCommand) Run(args []string) int {
 | 
						|
	flags := c.Meta.FlagSet("help", meta.FlagSetDefault)
 | 
						|
	flags.Usage = func() { c.Ui.Error(c.Help()) }
 | 
						|
	if err := flags.Parse(args); err != nil {
 | 
						|
		return 1
 | 
						|
	}
 | 
						|
 | 
						|
	args = flags.Args()
 | 
						|
	if len(args) != 1 {
 | 
						|
		flags.Usage()
 | 
						|
		c.Ui.Error("\nhelp expects a single argument")
 | 
						|
		return 1
 | 
						|
	}
 | 
						|
 | 
						|
	path := args[0]
 | 
						|
 | 
						|
	client, err := c.Client()
 | 
						|
	if err != nil {
 | 
						|
		c.Ui.Error(fmt.Sprintf(
 | 
						|
			"Error initializing client: %s", err))
 | 
						|
		return 2
 | 
						|
	}
 | 
						|
 | 
						|
	help, err := client.Help(path)
 | 
						|
	if err != nil {
 | 
						|
		if strings.Contains(err.Error(), "Vault is sealed") {
 | 
						|
			c.Ui.Error(`Error: Vault is sealed.
 | 
						|
 | 
						|
The path-help command requires the Vault to be unsealed so that
 | 
						|
mount points of secret backends are known.`)
 | 
						|
		} else {
 | 
						|
			c.Ui.Error(fmt.Sprintf(
 | 
						|
				"Error reading help: %s", err))
 | 
						|
		}
 | 
						|
		return 1
 | 
						|
	}
 | 
						|
 | 
						|
	c.Ui.Output(help.Help)
 | 
						|
	return 0
 | 
						|
}
 | 
						|
 | 
						|
func (c *PathHelpCommand) Synopsis() string {
 | 
						|
	return "Look up the help for a path"
 | 
						|
}
 | 
						|
 | 
						|
func (c *PathHelpCommand) Help() string {
 | 
						|
	helpText := `
 | 
						|
Usage: vault path-help [options] path
 | 
						|
 | 
						|
  Look up the help for a path.
 | 
						|
 | 
						|
  All endpoints in Vault from system paths, secret paths, and credential
 | 
						|
  providers provide built-in help. This command looks up and outputs that
 | 
						|
  help.
 | 
						|
 | 
						|
  The command requires that the Vault be unsealed, because otherwise
 | 
						|
  the mount points of the backends are unknown.
 | 
						|
 | 
						|
General Options:
 | 
						|
` + meta.GeneralOptionsUsage()
 | 
						|
	return strings.TrimSpace(helpText)
 | 
						|
}
 |