author Valentin Gosu <>
Thu, 29 Sep 2016 17:00:21 +0200
changeset 315763 e4508f246a862379bc3e40380f1972fa808fc685
parent 224814 4ec37503ea6a752baf92e053ede5f0ff7750ff36
child 315805 b9fddae1ada29d3616a36a36577176c3757aa464
permissions -rw-r--r--
Bug 1303762 - Add UI to about:networking to turn on logging modules at runtime r=jaws,mcmanus

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at */

#include "nsISupports.idl"

/* A JavaScript callback function that takes a JSON as its parameter.
 * The returned JSON contains arrays with data
[scriptable, function, uuid(19d7f24f-a95a-4fd9-87e2-d96e9e4b1f6d)]
interface NetDashboardCallback : nsISupports
    void onDashboardDataAvailable(in jsval data);

/* The dashboard service.
 * The async API returns JSONs, which hold arrays with the required info.
 * Only one request of each type may be pending at any time.
[scriptable, uuid(c79eb3c6-091a-45a6-8544-5a8d1ab79537)]
interface nsIDashboard : nsISupports
    /* Arrays: host, port, tcp, active, socksent, sockreceived
     * Values: sent, received  */
    void requestSockets(in NetDashboardCallback cb);

    /* Arrays: host, port, spdy, ssl
     * Array of arrays: active, idle */
    void requestHttpConnections(in NetDashboardCallback cb);

    /* Arrays: hostport, encrypted, msgsent, msgreceived, sentsize, receivedsize */
    void requestWebsocketConnections(in NetDashboardCallback cb);

    /* Arrays: hostname, family, hostaddr, expiration */
    void requestDNSInfo(in NetDashboardCallback cb);

    /* aProtocol: a transport layer protocol:
     *      ex: "ssl", "tcp", default is "tcp".
     * aHost: the host's name
     * aPort: the port which the connection will open on
     * aTimeout: the timespan before the connection will be timed out */
    void requestConnection(in ACString aHost, in unsigned long aPort,
                           in string aProtocol, in unsigned long aTimeout,
                           in NetDashboardCallback cb);

    /* When true, the service will log websocket events */
    attribute boolean enableLogging;

    /* DNS resolver for host name
     * aHost: host name */
    void requestDNSLookup(in ACString aHost, in NetDashboardCallback cb);

    AUTF8String getLogPath();