github.com/vmware/govmomi@v0.51.0/cli/host/vnic/hint.go (about)

     1  // © Broadcom. All Rights Reserved.
     2  // The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.
     3  // SPDX-License-Identifier: Apache-2.0
     4  
     5  package vnic
     6  
     7  import (
     8  	"context"
     9  	"errors"
    10  	"flag"
    11  	"io"
    12  
    13  	"github.com/vmware/govmomi/cli"
    14  	"github.com/vmware/govmomi/cli/flags"
    15  	"github.com/vmware/govmomi/vim25/types"
    16  )
    17  
    18  type hint struct {
    19  	*flags.HostSystemFlag
    20  }
    21  
    22  func init() {
    23  	cli.Register("host.vnic.hint", &hint{})
    24  }
    25  
    26  func (cmd *hint) Register(ctx context.Context, f *flag.FlagSet) {
    27  	cmd.HostSystemFlag, ctx = flags.NewHostSystemFlag(ctx)
    28  	cmd.HostSystemFlag.Register(ctx, f)
    29  }
    30  
    31  func (cmd *hint) Usage() string {
    32  	return "[DEVICE]..."
    33  }
    34  
    35  func (cmd *hint) Description() string {
    36  	return `Query virtual nic DEVICE hints.
    37  Examples:
    38    govc host.vnic.hint -host hostname
    39    govc host.vnic.hint -host hostname vmnic1`
    40  }
    41  
    42  type hintResult struct {
    43  	Hint []types.PhysicalNicHintInfo `json:"hint"`
    44  }
    45  
    46  func (i *hintResult) Write(w io.Writer) error {
    47  	// TODO: human friendly output
    48  	return errors.New("-xml, -json or -dump flag required")
    49  }
    50  
    51  func (cmd *hint) Run(ctx context.Context, f *flag.FlagSet) error {
    52  	ns, err := cmd.HostNetworkSystem()
    53  	if err != nil {
    54  		return err
    55  	}
    56  
    57  	hints, err := ns.QueryNetworkHint(ctx, f.Args())
    58  	if err != nil {
    59  		return err
    60  	}
    61  
    62  	return cmd.WriteResult(&hintResult{Hint: hints})
    63  }