Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

unit (interfaces)

date_range 30-May-24

Syntax

content_copy zoom_out_map
unit logical-unit-number {
    accept-source-mac {
        mac-address mac-address {
            policer {
                input cos-policer-name;
                output cos-policer-name;
            }
        }
    }
    accounting-profile name;
    advisory-options {
        downstream-rate rate;
        upstream-rate rate;
    }
    allow-any-vci;
    atm-scheduler-map (map-name | default);
    auto-configure {
        agent-circuit-identifier {
            dynamic-profile profile-name;
        }
        line-identity {
            include {
                accept-no-ids;
                circuit-id;
                remote-id;
                
            }
            dynamic-profile profile-name;
        }
    }
    backup-options {
        interface interface-name;
    }
    bandwidth rate;
    cell-bundle-size cells;
    clear-dont-fragment-bit;
    compression {
        rtp {
            maximum-contexts number <force>;
            f-max-period number;
            queues [queue-numbers];
            port {
                minimum port-number;
                maximum port-number;
            }
        }
    }
    compression-device interface-name;
    copy-tos-to-outer-ip-header;
    demux {
        inet {
            address-source address;
            auto-configure {
                address-ranges {
                    authentication {
                        password password-string;
                        username-include {
                            auth-server-realm realm-string;
                            delimiter delimiter-character;
                            domain-name domain-name;
                            interface-name;
                            source-address;
                            user-prefix user-prefix-string;
                        }
                    }
                    dynamic-profile profile-name {
                        network ip-address {
                            range name {
                                low lower-limit;
                                high upper-limit;
                            }
                        }
                    }
                }
                
            }
        }
        inet6 {
            address-source address;
            auto-configure {
                address-ranges {
                    authentication {
                        password password-string;
                        username-include {
                            auth-server-realm realm-string;
                            delimiter delimiter-character;
                            domain-name domain-name;
                            interface-name;
                            source-address;
                            user-prefix user-prefix-string;
                        }
                    }
                    dynamic-profile profile-name {
                        network ip-address {
                            range name {
                                low lower-limit;
                                high upper-limit;
                            }
                        }
                    }
                }
                
            }
        }
    }
    demux-destination family;
    demux-source family;
    demux-options {
        underlying-interface interface-name;
    }
    description text;
    etree-ac-role (leaf | root);
    interface {
        l2tp-interface-id name;
        (dedicated | shared);
    }
    dialer-options {
        activation-delay seconds;
        callback;
        callback-wait-period time;
        deactivation-delay seconds;
        dial-string [dial-string-numbers];
        idle-timeout seconds;
        incoming-map {
            caller caller-id | accept-all;
            initial-route-check seconds;
            load-interval seconds;
            load-threshold percent;
            pool pool-name;
            redial-delay time;
            watch-list {
                [routes];
            }
        }
    }
    disable;
    disable-mlppp-inner-ppp-pfc;
    dlci dlci-identifier;
    drop-timeout milliseconds;
    dynamic-call-admission-control {
        activation-priority priority;
        bearer-bandwidth-limit kilobits-per-second;
    }
    encapsulation type;
    epd-threshold cells plp1 cells;
    family family-name {
        ... the family subhierarchy appears after the main [edit interfaces interface-name unit logical-unit-number] hierarchy ...
    }
    fragment-threshold bytes;
    host-prefix-only;
    inner-vlan-id-range start start-id end end-id;
    input-vlan-map {
        (pop | pop-pop | pop-swap | push | push-push | swap |
        swap-push | swap-swap);
        inner-tag-protocol-id tpid;
        inner-vlan-id number;
        tag-protocol-id tpid;
        vlan-id number;
    }
    interleave-fragments;
    inverse-arp;
    layer2-policer {
        input-policer policer-name;
        input-three-color policer-name;
        output-policer policer-name;
        output-three-color policer-name;
    }
    link-layer-overhead percent;
    minimum-links number;
    mrru bytes;
    multicast-dlci dlci-identifier;
    multicast-vci vpi-identifier.vci-identifier;
    multilink-max-classes number;
    multipoint;
    oam-liveness {
        up-count cells;
        down-count cells;
    }
    oam-period (disable | seconds);
    output-vlan-map {
        (pop | pop-pop | pop-swap | push | push-push | swap |
        swap-push | swap-swap);
        inner-tag-protocol-id tpid;
        inner-vlan-id number;
        tag-protocol-id tpid;
    }
    passive-monitor-mode;
    peer-unit unit-number;
    plp-to-clp;
    point-to-point;
    ppp-options {
        mru size;
        mtu (size | use-lower-layer);
        chap {
            access-profile name;
            default-chap-secret name;
            local-name name;
            passive;
        }
        compression {
            acfc;
            pfc;
        }
        dynamic-profile profile-name;
        ipcp-suggest-dns-option;
        lcp-restart-timer milliseconds;
        loopback-clear-timer seconds;
        ncp-restart-timer milliseconds;
        pap {
            access-profile name;
            default-pap-password password;
            local-name name;
            local-password password;
            passive;
        }
    }
    pppoe-options {
        access-concentrator name;
        auto-reconnect seconds;
        (client | server);
        service-name name;
        underlying-interface interface-name;
    }
    pppoe-underlying-options {
        access-concentrator name;
        direct-connect;
        dynamic-profile profile-name;
        max-sessions number;
    }
    proxy-arp;
    service-domain (inside | outside);
    shaping {
        (cbr rate | rtvbr peak rate sustained rate burst length | vbr peak rate sustained rate burst length);
        queue-length number;
    }
    short-sequence;
    targeted-distribution;
    transmit-weight number;
    (traps | no-traps);
    trunk-bandwidth rate;
    trunk-id number;
    tunnel {
        backup-destination address;
        destination address;
        key number;
        routing-instance {
            destination routing-instance-name;
        }
        source source-address;
        ttl number;
    }
    vci vpi-identifier.vci-identifier;
    vci-range start start-vci end end-vci;
    vpi vpi-identifier;
    vlan-id number;
    vlan-id-range number-number;
    vlan-tags inner tpid.vlan-id outer tpid.vlan-id;
    family family {
        accounting {
            destination-class-usage;
            source-class-usage {
                (input | output | input output);
            }
        }
        access-concentrator name;
        address address {
            ... the address subhierarchy appears after the main [edit interfaces interface-name unit logical-unit-number family family-name] hierarchy ...
        }
        bundle interface-name;
        core-facing;
        demux-destination {
            destination-prefix;
        }
        demux-source {
            source-prefix;
        }
        direct-connect;
        duplicate-protection;
        dynamic-profile profile-name;
        filter {
            group filter-group-number;
            input filter-name;
            input-list [filter-names];
            output filter-name;
            output-list [filter-names];
        }
        interface-mode (access | trunk);
        ipsec-sa sa-name;
        keep-address-and-control;
        mac-validate (loose | strict);
        max-sessions number;
        mtu bytes;
        multicast-only;
        no-redirects;
        policer {
            arp policer-template-name;
            input policer-template-name;
            output policer-template-name;
        }
        primary;
        protocols [inet iso mpls];
        proxy inet-address address;
        receive-options-packets;
        receive-ttl-exceeded;
        remote (inet-address address | mac-address address);
        rpf-check {
            fail-filter filter-name
            mode loose;
        }
        sampling {
            input;
            output;
        }
        service {
            input {
                post-service-filter filter-name;
                service-set service-set-name <service-filter filter-name>;
            }
            output {
                service-set service-set-name <service-filter filter-name>;
            }
        }
        service-name-table table-name
        targeted-options {
            backup backup;
            group group;
            primary primary;
            weight ($junos-interface-target-weight | weight-value);
        }
        (translate-discard-eligible | no-translate-discard-eligible);
        (translate-fecn-and-becn | no-translate-fecn-and-becn);
        translate-plp-control-word-de;
        unnumbered-address interface-name destination address destination-profile profile-name;
        vlan-id number;
        vlan-id-list [number number-number];
        address address {
            arp ip-address (mac | multicast-mac) mac-address <publish>;
            broadcast address;
            destination address;
            destination-profile name;
            eui-64;
            primary-only;
            multipoint-destination address {
                dlci dlci-identifier;
                epd-threshold cells <plp1 cells>;
                inverse-arp;
                oam-liveness {
                    up-count cells;
                    down-count cells;
                }
                oam-period (disable | seconds);
                shaping {
                    (cbr rate | rtvbr burst length peak rate sustained rate | vbr burst length peak rate sustained rate);
                    queue-length number;
                }
                vci vpi-identifier.vci-identifier;
            }
            preferred;
            primary;
            (vrrp-group | vrrp-inet6-group) group-number {
                (accept-data | no-accept-data);
                advertise–interval seconds;
                authentication-type authentication;
                authentication-key key;
                fast-interval milliseconds;
                (preempt | no-preempt) {
                    hold-time seconds;
                }
                priority number;
                track {
                    interface interface-name {
                        bandwidth-threshold bits-per-second priority-cost number;
                    }
                    priority-hold-time seconds;
                    route ip-address/prefix-length routing-instance instance-name priority-cost cost;
                }
                virtual-address [addresses];
                virtual-link-local-address ipv6–address;
                vrrp-inherit-from {
                    active-interface interface-name;
                    active-group group-number;
                }
            }
        }
    }
}

Hierarchy Level

content_copy zoom_out_map
[edit interfaces interface-name],
[edit logical-systems logical-system-name interfaces interface-name],
[edit interfaces interface-set interface-set-name interface interface-name]

Description

Configure a logical interface on the physical device. You must configure a logical interface to be able to use the physical device.

Options

logical-unit-number—Number of the logical unit.

  • Range: 0 through 1,073,741,823 for demux, PPPoE, and pseudowire static interfaces. 0 through 16,385 for all other static interface types.

etree-ac-role (leaf | root)—To configure an interface as either leaf or root.

The remaining statements are explained separately. Search for a statement in CLI Explorer or click a linked statement in the Syntax section for details.

Required Privilege Level

interface—To view this statement in the configuration.

interface-control—To add this statement to the configuration.

Release Information

Statement introduced before Junos OS Release 7.4.

Range increased for static pseudowire interfaces to 1,073,741,823 in Junos OS Release 18.3R1.

footer-navigation