コンストラクタの詳細

• TunnelPoolManager

  public TunnelPoolManager​(RouterContext ctx)

メソッドの詳細

• selectInboundTunnel

  public TunnelInfo selectInboundTunnel​()

  Pick a random inbound exploratory tunnel. Warning - selectInboundExploratoryTunnel(Hash) is preferred.

  定義:

  selectInboundTunnel インタフェース内 TunnelManagerFacade

  戻り値:

  null if none

• selectInboundTunnel

  public TunnelInfo selectInboundTunnel​(Hash destination)

  Pick a random inbound tunnel from the given destination's pool. Warning - selectOutboundTunnel(Hash, Hash) is preferred.

  定義:

  selectInboundTunnel インタフェース内 TunnelManagerFacade

  パラメータ:

  destination - if null, returns inbound exploratory tunnel

  戻り値:

  null if none

• selectOutboundTunnel

  public TunnelInfo selectOutboundTunnel​()

  Pick a random outbound exploratory tunnel. Warning - selectOutboundExploratoryTunnel(Hash) is preferred.

  定義:

  selectOutboundTunnel インタフェース内 TunnelManagerFacade

  戻り値:

  null if none

• selectOutboundTunnel

  public TunnelInfo selectOutboundTunnel​(Hash destination)

  Pick a random outbound tunnel from the given destination's pool. Warning - selectOutboundTunnel(Hash, Hash) is preferred.

  定義:

  selectOutboundTunnel インタフェース内 TunnelManagerFacade

  パラメータ:

  destination - if null, returns outbound exploratory tunnel

  戻り値:

  null if none

• selectInboundExploratoryTunnel

  public TunnelInfo selectInboundExploratoryTunnel​(Hash closestTo)

  Pick the inbound exploratory tunnel with the gateway closest to the given hash. By using this instead of the random selectTunnel(), we force some locality in OBEP-IBGW connections to minimize those connections network-wide.

  定義:

  selectInboundExploratoryTunnel インタフェース内 TunnelManagerFacade

  パラメータ:

  closestTo - non-null

  戻り値:

  null if none

  導入されたバージョン:

  0.8.10

• selectInboundTunnel

  public TunnelInfo selectInboundTunnel​(Hash destination,
                                        Hash closestTo)

  Pick the inbound tunnel with the gateway closest to the given hash from the given destination's pool. By using this instead of the random selectTunnel(), we force some locality in OBEP-IBGW connections to minimize those connections network-wide.

  定義:

  selectInboundTunnel インタフェース内 TunnelManagerFacade

  パラメータ:

  destination - if null, returns inbound exploratory tunnel

  closestTo - non-null

  戻り値:

  null if none

  導入されたバージョン:

  0.8.10

• selectOutboundExploratoryTunnel

  public TunnelInfo selectOutboundExploratoryTunnel​(Hash closestTo)

  Pick the outbound exploratory tunnel with the endpoint closest to the given hash. By using this instead of the random selectTunnel(), we force some locality in OBEP-IBGW connections to minimize those connections network-wide.

  定義:

  selectOutboundExploratoryTunnel インタフェース内 TunnelManagerFacade

  パラメータ:

  closestTo - non-null

  戻り値:

  null if none

  導入されたバージョン:

  0.8.10

• selectOutboundTunnel

  public TunnelInfo selectOutboundTunnel​(Hash destination,
                                         Hash closestTo)

  Pick the outbound tunnel with the endpoint closest to the given hash from the given destination's pool. By using this instead of the random selectTunnel(), we force some locality in OBEP-IBGW connections to minimize those connections network-wide.

  定義:

  selectOutboundTunnel インタフェース内 TunnelManagerFacade

  パラメータ:

  destination - if null, returns outbound exploratory tunnel

  closestTo - non-null

  戻り値:

  null if none

  導入されたバージョン:

  0.8.10

• getTunnelInfo

  @Deprecated
  public TunnelInfo getTunnelInfo​(TunnelId id)

  推奨されていません。 unused
  Expensive (iterates through all tunnels of all pools) and unnecessary.

  定義:

  getTunnelInfo インタフェース内 TunnelManagerFacade

  パラメータ:

  id - the tunnelId as seen at the gateway

• getFreeTunnelCount

  public int getFreeTunnelCount​()

  インタフェースからコピーされた説明: TunnelManagerFacade
  how many free inbound tunnels do we have available?

  定義:

  getFreeTunnelCount インタフェース内 TunnelManagerFacade

  戻り値:

  number of inbound exploratory tunnels

• getOutboundTunnelCount

  public int getOutboundTunnelCount​()

  インタフェースからコピーされた説明: TunnelManagerFacade
  how many outbound tunnels do we have available?

  定義:

  getOutboundTunnelCount インタフェース内 TunnelManagerFacade

  戻り値:

  number of outbound exploratory tunnels

• getInboundClientTunnelCount

  public int getInboundClientTunnelCount​()

  インタフェースからコピーされた説明: TunnelManagerFacade
  how many free inbound client tunnels do we have available?

  定義:

  getInboundClientTunnelCount インタフェース内 TunnelManagerFacade

• getOutboundClientTunnelCount

  public int getOutboundClientTunnelCount​()

  インタフェースからコピーされた説明: TunnelManagerFacade
  how many outbound client tunnels do we have available?

  定義:

  getOutboundClientTunnelCount インタフェース内 TunnelManagerFacade

• getOutboundClientTunnelCount

  public int getOutboundClientTunnelCount​(Hash destination)

  Use to verify a tunnel pool is alive

  定義:

  getOutboundClientTunnelCount インタフェース内 TunnelManagerFacade

  導入されたバージョン:

  0.7.11

• getParticipatingCount

  public int getParticipatingCount​()

  インタフェースからコピーされた説明: TunnelManagerFacade
  how many tunnels are we participating in?

  定義:

  getParticipatingCount インタフェース内 TunnelManagerFacade

• getLastParticipatingExpiration

  public long getLastParticipatingExpiration​()

  インタフェースからコピーされた説明: TunnelManagerFacade
  When does the last tunnel we are participating in expire?

  定義:

  getLastParticipatingExpiration インタフェース内 TunnelManagerFacade

• getShareRatio

  public double getShareRatio​()

  定義:

  getShareRatio インタフェース内 TunnelManagerFacade

  戻り値:

  (number of part. tunnels) / (estimated total number of hops in our expl.+client tunnels) 100 max. We just use length setting, not variance, for speed

  導入されたバージョン:

  0.7.10

• isValidTunnel

  public boolean isValidTunnel​(Hash client,
                               TunnelInfo tunnel)

  インタフェースからコピーされた説明: TunnelManagerFacade
  Is a tunnel a valid member of the pool?

  定義:

  isValidTunnel インタフェース内 TunnelManagerFacade

• getInboundSettings

  public TunnelPoolSettings getInboundSettings​()

  exploratory

  定義:

  getInboundSettings インタフェース内 TunnelManagerFacade

• getOutboundSettings

  public TunnelPoolSettings getOutboundSettings​()

  exploratory

  定義:

  getOutboundSettings インタフェース内 TunnelManagerFacade

• setInboundSettings

  public void setInboundSettings​(TunnelPoolSettings settings)

  exploratory

  定義:

  setInboundSettings インタフェース内 TunnelManagerFacade

• setOutboundSettings

  public void setOutboundSettings​(TunnelPoolSettings settings)

  exploratory

  定義:

  setOutboundSettings インタフェース内 TunnelManagerFacade

• getInboundSettings

  public TunnelPoolSettings getInboundSettings​(Hash client)

  定義:

  getInboundSettings インタフェース内 TunnelManagerFacade

• getOutboundSettings

  public TunnelPoolSettings getOutboundSettings​(Hash client)

  定義:

  getOutboundSettings インタフェース内 TunnelManagerFacade

• setInboundSettings

  public void setInboundSettings​(Hash client,
                                 TunnelPoolSettings settings)

  定義:

  setInboundSettings インタフェース内 TunnelManagerFacade

• setOutboundSettings

  public void setOutboundSettings​(Hash client,
                                  TunnelPoolSettings settings)

  定義:

  setOutboundSettings インタフェース内 TunnelManagerFacade

• restart

  public void restart​()

  インタフェースからコピーされた説明: Service
  Perform a soft restart.

  定義:

  restart インタフェース内 Service

• buildTunnels

  public void buildTunnels​(Destination client,
                           ClientTunnelSettings settings)

  Used only at session startup. Do not use to change settings. Do not use for aliased destinations; use addAlias().

  定義:

  buildTunnels インタフェース内 TunnelManagerFacade

• addAlias

  public boolean addAlias​(Destination dest,
                          ClientTunnelSettings settings,
                          Destination existingClient)

  Add another destination to the same tunnels. Must have same encryption key and a different signing key.

  定義:

  addAlias インタフェース内 TunnelManagerFacade

  戻り値:

  success

  例外:

  java.lang.IllegalArgumentException - if not

  導入されたバージョン:

  0.9.21

• removeAlias

  public void removeAlias​(Destination dest)

  Remove a destination for the same tunnels as another.

  定義:

  removeAlias インタフェース内 TunnelManagerFacade

  導入されたバージョン:

  0.9.21

• removeTunnels

  public void removeTunnels​(Hash destination)

  This will be called twice, once by the inbound and once by the outbound pool. Synched with buildTunnels() above.

• buildComplete

  void buildComplete​(PooledTunnelCreatorConfig cfg)

  queue a recurring test job if appropriate

• startup

  public void startup​()

  インタフェースからコピーされた説明: Service
  Instruct the service that it should start normal operation. This call DOES block until the service is ready.

  定義:

  startup インタフェース内 Service

• shutdown

  public void shutdown​()

  Cannot be restarted

  定義:

  shutdown インタフェース内 Service

• listPools

  public void listPools​(java.util.List<TunnelPool> out)

  list of TunnelPool instances currently in play

  定義:

  listPools インタフェース内 TunnelManagerFacade

• tunnelFailed

  void tunnelFailed​()

• getExecutor

  BuildExecutor getExecutor​()

• isShutdown

  boolean isShutdown​()

• getInboundBuildQueueSize

  public int getInboundBuildQueueSize​()

  インタフェースからコピーされた説明: TunnelManagerFacade
  count how many inbound tunnel requests we have received but not yet processed

  定義:

  getInboundBuildQueueSize インタフェース内 TunnelManagerFacade

• renderStatusHTML

  @Deprecated
  public void renderStatusHTML​(java.io.Writer out)
                        throws java.io.IOException

  推奨されていません。 moved to routerconsole

  定義:

  renderStatusHTML インタフェース内 Service

  例外:

  java.io.IOException

• selectPeersInTooManyTunnels

  public java.util.Set<Hash> selectPeersInTooManyTunnels​()

  For reliability reasons, don't allow a peer in more than x% of client and exploratory tunnels. This also will prevent a single huge-capacity (or malicious) peer from taking all the tunnels in the network (although it would be nice to limit the % of total network tunnels to 10% or so, but that appears to be too low to set as a default here... much lower than 33% will push client tunnels out of the fast tier into high cap or beyond...) Possible improvement - restrict based on count per IP, or IP block, to slightly increase costs of collusion

  定義:

  selectPeersInTooManyTunnels インタフェース内 TunnelManagerFacade

  戻り値:

  Set of peers that should not be allowed in another tunnel

• getInboundClientPools

  public java.util.Map<Hash,TunnelPool> getInboundClientPools​()

  for TunnelRenderer in router console

  定義:

  getInboundClientPools インタフェース内 TunnelManagerFacade

• getOutboundClientPools

  public java.util.Map<Hash,TunnelPool> getOutboundClientPools​()

  for TunnelRenderer in router console

  定義:

  getOutboundClientPools インタフェース内 TunnelManagerFacade

• getInboundExploratoryPool

  public TunnelPool getInboundExploratoryPool​()

  For TunnelRenderer in router console

  定義:

  getInboundExploratoryPool インタフェース内 TunnelManagerFacade

  戻り値:

  non-null

• getOutboundExploratoryPool

  public TunnelPool getOutboundExploratoryPool​()

  For TunnelRenderer in router console

  定義:

  getOutboundExploratoryPool インタフェース内 TunnelManagerFacade

  戻り値:

  non-null

• getInboundPool

  public TunnelPool getInboundPool​(Hash client)

  定義:

  getInboundPool インタフェース内 TunnelManagerFacade

  戻り値:

  pool or null

  導入されたバージョン:

  0.9.34

• getOutboundPool

  public TunnelPool getOutboundPool​(Hash client)

  定義:

  getOutboundPool インタフェース内 TunnelManagerFacade

  戻り値:

  pool or null

  導入されたバージョン:

  0.9.34

• fail

  public void fail​(Hash peer)

  Fail all outbound tunnels with this peer as first hop, and all inbound tunnels with this peer as the last hop, baecause we can't contact it any more. This is most likely to be triggered by an outbound tunnel.

  定義:

  fail インタフェース内 TunnelManagerFacade

  導入されたバージョン:

  0.8.13