# traffic: Traffic on Domain

The `traffic` utility serves to manage traffic usage statistics for domains. Using this utility, you can perform the following tasks:

- register certain amount of traffic
- subtract certain amount of traffic
- register certain amount of traffic from batch
- reset traffic

Note

The utility is available since Plesk 9.

## Usage

    traffic <command> [<param>] [
    <option 1> <param> [<option 2> <param> ... [<option N> <param>]
    ]

## Example

The following command adds 100Mb of inbound HTTP traffic to example.com traffic:

    plesk bin traffic -a example.com -date 2008-10-17 -type http -value 100M -direction in

## Commands

Command | Parameter | Description | Example
--- | --- | --- | ---
`--add` or `-a` | `<domain name>` | Registers specified amount of traffic as if being already used by domain. Requires all options. | To add 100Mb of inbound HTTP traffic to example.com traffic:
    plesk bin traffic -a example.com -date 2008-10-17 -type http -value 100M -direction in
`--add-user or -au` | `<login>` | Registers specified amount of traffic as if being already used by client/reseller. Requires all options. | To add 100Mb of inbound HTTP traffic to the traffic of user with the login name jdoe:
    plesk bin traffic -a jdoe -date 2008-10-17 -type http -value 100M -direction in
`--sub` or `-s` | `<domain name>` | Subtracts specified amount of traffic from the amount registered for domain. Requires all options. | To subtract 100Mb of inbound HTTP traffic from example.com traffic:
    plesk bin traffic -s example.com -date 2008-10-17 -type http -value 100M -direction in
`--sub-user or -su` | `<login>` | Subtracts specified amount of traffic from the amount registered for client/reseller. Requires all options. | To subtract 100Mb of inbound HTTP traffic from the traffic of user with the login name jdoe:
    plesk bin traffic -s jdoe -date 2008-10-17 -type http -value 100M -direction in
`--add-batch` or `-b` | `<domain name>` | Registers in batch mode specified amount of traffic as if being already used by domain. Requires all options. | To register traffic on example.com using file `traf.conf`:
    plesk bin traffic -b example.com < traf.conf
The contents of `traf.conf` can be as follows:
    -date 2008-10-17 -type http -value 10M -direction in
`--add-batch-user or -bu` | `<login>` | Registers in batch mode specified amount of traffic as if being already used by client/reseller. Requires all options. | To register traffic used by user with the login name jdoe using file `traf.conf`:
    plesk bin traffic -b jdoe < traf.conf
The contents of `traf.conf` can be as follows:
    -date 2008-10-17 -type http -value 10M -direction in
`--del` or `-d` | `<domain name>` | Resets the amount of traffic registered for this domain to zero. Requires `-date`, `-type`, `-direction` options. | To reset outbound traffic for example.com:
    plesk bin traffic -d example.com -date 2008-10-17 -type http -direction out
`--del-user or -d` | `<login>` | Resets the amount of traffic registered for this client/reseller to zero. Requires `-date`, `-type`, `-direction` options. | To reset outbound traffic for user with the login name jdoe:
    plesk bin traffic -d jdoe -date 2008-10-17 -type http -direction out
`--help` or `-h` |  | Displays help on the utility usage. | To view the help info on the use of this utility:
    plesk bin traffic --help

## Options

Option | Parameter | Description | Example
--- | --- | --- | ---
`-date` | `<YYYY-MM-DD>` | Sets timestamp for the traffic statistics change being performed. | To add 100Mb of inbound HTTP traffic to example.com traffic:
    plesk bin traffic -a example.com -date 2008-10-17 -type http -value 100M -direction in
`-type` | `http|ftp|pop3-imap|smtp>` | Specifies the traffic type. |
`-value` | `<number>[B|K|M|G|T]` | Specifies the amount of added/subtracted traffic. |
`-direction` | `in|out` | Specifies the traffic direction. |