Documentation

Overview

    Command proxyd is a daemon that listens for connections from Vanadium services (typically behind NATs) and proxies these services to the outside world.

    Usage:

    xproxyd [flags]
    

    The xproxyd flags are:

    -access-list=
      Blessings that are authorized to listen via the proxy.  JSON-encoded
      representation of access.AccessList.  An empty string implies the default
      authorization policy.
    -healthz-address=
      Network address on which the HTTP healthz server runs.  It is intended to be
      used with a load balancer.  The load balancer must be able to reach this
      address in order to verify that the proxy server is running.
    -name=
      Name to mount the proxy as.
    -stats-access-list=
      Blessings that are authorized to access the proxy's statistics.  JSON-encoded
      representation of access.AccessList.  An empty string implies the default
      authorization policy.
    

    The global flags are:

    -alsologtostderr=true
      log to standard error as well as files
    -log_backtrace_at=:0
      when logging hits line file:N, emit a stack trace
    -log_dir=
      if non-empty, write log files to this directory
    -logtostderr=false
      log to standard error instead of files
    -max_stack_buf_size=4292608
      max size in bytes of the buffer to use for logging stack traces
    -metadata=<just specify -metadata to activate>
      Displays metadata for the program and exits.
    -stderrthreshold=2
      logs at or above this threshold go to stderr
    -time=false
      Dump timing information to stderr before exiting the program.
    -v=0
      log level for V logs
    -v23.credentials=
      directory to use for storing security credentials
    -v23.i18n-catalogue=
      18n catalogue files to load, comma separated
    -v23.namespace.root=[/(dev.v.io:r:vprod:service:mounttabled)@ns.dev.v.io:8101]
      local namespace root; can be repeated to provided multiple roots
    -v23.permissions.file=
      specify a perms file as <name>:<permsfile>
    -v23.permissions.literal=
      explicitly specify the runtime perms as a JSON-encoded access.Permissions.
      Overrides all --v23.permissions.file flags
    -v23.proxy=
      object name of proxy service to use to export services across network
      boundaries
    -v23.proxy.limit=0
      max number of proxies to connect to when the policy is to connect to all
      proxies; 0 implies all proxies
    -v23.proxy.policy=
      policy for choosing from a set of available proxy instances
    -v23.tcp.address=
      address to listen on
    -v23.tcp.protocol=
      protocol to listen with
    -v23.virtualized.advertise-private-addresses=
      if set the process will also advertise its private addresses
    -v23.virtualized.disallow-native-fallback=false
      if set, a failure to detect the requested virtualization provider will result
      in an error, otherwise, native mode is used
    -v23.virtualized.dns.public-name=
      if set the process will use the supplied dns name (and port) without
      resolution for its entry in the mounttable
    -v23.virtualized.docker=
      set if the process is running in a docker container and needs to configure
      itself differently therein
    -v23.virtualized.provider=
      the name of the virtualization/cloud provider hosting this process if the
      process needs to configure itself differently therein
    -v23.virtualized.tcp.public-address=
      if set the process will use this address (resolving via dns if appropriate)
      for its entry in the mounttable
    -v23.virtualized.tcp.public-protocol=
      if set the process will use this protocol for its entry in the mounttable
    -v23.vtrace.cache-size=1024
      The number of vtrace traces to store in memory
    -v23.vtrace.collect-regexp=
      Spans and annotations that match this regular expression will trigger trace
      collection
    -v23.vtrace.dump-on-shutdown=true
      If true, dump all stored traces on runtime shutdown
    -v23.vtrace.sample-rate=0
      Rate (from 0.0 to 1.0) to sample vtrace traces
    -v23.vtrace.v=0
      The verbosity level of the log messages to be captured in traces
    -vmodule=
      comma-separated list of globpattern=N settings for filename-filtered logging
      (without the .go suffix).  E.g. foo/bar/baz.go is matched by patterns baz or
      *az or b* but not by bar/baz or baz.go or az or b.*
    -vpath=
      comma-separated list of regexppattern=N settings for file pathname-filtered
      logging (without the .go suffix).  E.g. foo/bar/baz.go is matched by patterns
      foo/bar/baz or fo.*az or oo/ba or b.z but not by foo/bar/baz.go or fo*az
    

    Source Files