diff options
authorRobert Schwebel <>2005-03-16 15:17:59 +0000
committerRobert Schwebel <>2005-03-16 15:17:59 +0000
commit45c875898aa71d7054c84bb0fe46b5a777691f26 (patch)
parentc6f3feff0b1cfd4f85874a8d43b8e708fe67c2b1 (diff)
added documentation
git-svn-id: 5fd5a299-6ef2-0310-aa18-8b01d7c39d8c
1 files changed, 57 insertions, 195 deletions
diff --git a/canconfig.8 b/canconfig.8
index 3666af5..df6765a 100644
--- a/canconfig.8
+++ b/canconfig.8
@@ -1,211 +1,73 @@
.TH CANCONFIG 8 "13 March 2005" "canutils" "Linux Programmer's Manual"
-canconfig \- configure a CAN bus (Controller Area Network) interface
+canconfig \- configure a CAN bus interface
-.B "canconfig [interface]"
+.B "canconfig <interface>"
-.B "canconfig interface [aftype] options | address ..."
+.B "canconfig <interface> baudrate { BR | BTR }"
+.B "canconfig <interface> mode MODE"
+.B "canconfig <interface> state"
-.B Ifconfig
-is used to configure the kernel-resident network interfaces. It is
-used at boot time to set up interfaces as necessary. After that, it
-is usually only needed when debugging or when system tuning is needed.
-If no arguments are given,
-.B ifconfig
-displays the status of the currently active interfaces. If
-a single
-.B interface
-argument is given, it displays the status of the given interface
-only; if a single
-.B -a
-argument is given, it displays the status of all interfaces, even
-those that are down. Otherwise, it configures an interface.
+.B canconfig
+is used to configure the kernel-resident CAN (Controller Area Network)
+interfaces. As CAN cards are network devices the basic configuration
+options can be done with ifconfig.
-.SH Address Families
-If the first argument after the interface name is recognized as
-the name of a supported address family, that address family is
-used for decoding and displaying all protocol addresses. Currently
-supported address families include
-.B inet
-(TCP/IP, default),
-.B inet6
-.B ax25
-(AMPR Packet Radio),
-.B ddp
-(Appletalk Phase 2),
-.B ipx
-(Novell IPX) and
-.B netrom
-(AMPR Packet radio).
+ canconfig <dev> baudrate { BR | BTR }
+ BR := { 10 | 20 | 50 | 100 | 125 | 250 | 500 | 800 | 1000 }
+ BTR := btr <btr0> [ <btr1> [ <btr2> ] ]
+ canconfig <dev> mode MODE
+ MODE := { start }
+ canconfig <dev> state
.B interface
-The name of the interface. This is usually a driver name followed by
-a unit number, for example
-.B eth0
-for the first Ethernet interface.
-.B up
-This flag causes the interface to be activated. It is implicitly
-specified if an address is assigned to the interface.
-.B down
-This flag causes the driver for this interface to be shut down.
-.B "[\-]arp"
-Enable or disable the use of the ARP protocol on this interface.
-.B "[\-]promisc"
-Enable or disable the
-.B promiscuous
-mode of the interface. If selected, all packets on the network will
-be received by the interface.
-.B "[\-]allmulti"
-Enable or disable
-.B all-multicast
-mode. If selected, all multicast packets on the network will be
-received by the interface.
-.B "metric N"
-This parameter sets the interface metric.
-.B "mtu N"
-This parameter sets the Maximum Transfer Unit (MTU) of an interface.
-.B "dstaddr addr"
-Set the remote IP address for a point-to-point link (such as
-PPP). This keyword is now obsolete; use the
-.B pointopoint
-keyword instead.
-.B "netmask addr"
-Set the IP network mask for this interface. This value defaults to the
-usual class A, B or C network mask (as derived from the interface IP
-address), but it can be set to any value.
-.B "add addr/prefixlen"
-Add an IPv6 address to an interface.
-.B "del addr/prefixlen"
-Remove an IPv6 address from an interface.
-.B "tunnel"
-Create a new SIT (IPv6-in-IPv4) device, tunnelling to the given destination.
-.B "irq addr"
-Set the interrupt line used by this device. Not all devices can
-dynamically change their IRQ setting.
-.B "io_addr addr"
-Set the start address in I/O space for this device.
+The name of the interface. This is usually a driver name followed by
+a unit number, for example "can0".
-.B "mem_start addr"
-Set the start address for shared memory used by this device. Only a
-few devices need this.
-.B "media type"
-Set the physical port or medium type to be used by the device. Not
-all devices can change this setting, and those that can vary in what
-values they support. Typical values for
-.B type
-.B 10base2
-(thin Ethernet),
-.B 10baseT
-(twisted-pair 10Mbps Ethernet),
-(external transceiver) and so on. The special medium type of
-.B auto
-can be used to tell the driver to auto-sense the media. Again, not
-all drivers can do this.
-.B "[-]broadcast [addr]"
-If the address argument is given, set the protocol broadcast
-address for this interface. Otherwise, set (or clear) the
-flag for the interface.
-.B "[-]pointopoint [addr]"
-This keyword enables the
-.B point-to-point
-mode of an interface, meaning that it is a direct link between two
-machines with nobody else listening on it.
+.B baudrate
+The baudrate of the CAN interface can be set with a simple and complex
+method, which are chosen by using BR or BTR with the "baudrate" command.
-If the address argument is also given, set the protocol address of
-the other side of the link, just like the obsolete
-.B dstaddr
-keyword does. Otherwise, set or clear the
-flag for the interface.
-.B hw class address
-Set the hardware address of this interface, if the device driver
-supports this operation. The keyword must be followed by the
-name of the hardware class and the printable ASCII equivalent of
-the hardware address. Hardware classes currently supported include
-.B ether
-.B ax25
-(AMPR AX.25),
-.B ARCnet
-.B netrom
-.B multicast
-Set the multicast flag on the interface. This should not normally be needed
-as the drivers set the flag correctly themselves.
+.B BR:
+The baudrate of the interface can be set to one of the standard baud
+rates by setting a BR value. Example:
+ canconfig can0 baudrate 125
+to set the interface can0 to 125 kBit/s. The standard baudrates are 10,
+20, 50, 100, 125, 250, 500, 800 and 1000 kBit/s.
+.B BTR:
+The CAN standard defines a second way for setting the baudrate, which
+uses a set of Bit Timing Registers (BTR). The number of and exact
+meaning of the BTR registers is chip dependend, so this interface offers
+the possibility to handle three BTR registers directly to the driver:
+ canconfig can0 baudrate btr <brt1> <btr2> <btr3>
-.B address
-The IP address to be assigned to this interface.
+.B mode
+This command sets the CAN controller into "start" mode. Example:
+ canconfig can0 mode start
-.B txqueuelen length
-Set the length of the transmit queue of the device. It is useful to set this
-to small values for slower devices with a high latency (modem links, ISDN)
-to prevent fast bulk transfers from disturbing interactive traffic like
-telnet too much.
-Since kernel release 2.2 there are no explicit interface statistics for
-alias interfaces anymore. The statistics printed for the original address
-are shared with all alias addresses on the same device. If you want per-address
-statistics you should add explicit accounting
-rules for the address using the
-.BR ipchains(8)
-Since net-tools 1.60-4 ifconfig is printing byte counters and human readable
-counters with IEC 60027-2 units. So 1 KiB are 2^10 byte. Note, the numbers
-are truncated to one decimal (which can by quite a large error if you
-consider 0.1 PiB is 112.589.990.684.262 bytes :)
-Interrupt problems with Ethernet device drivers fail with EAGAIN
-.I (SIOCSIIFLAGS: Resource temporarily unavailable)
-it is most likely a interrupt conflict. See
-for more information.
-.I /proc/net/socket
-.I /proc/net/dev
+.B state
+This command lets you ask for the interface status.
-.I /proc/net/if_inet6
-While appletalk DDP and IPX addresses will be displayed they cannot be
-altered by this command.
-route(8), netstat(8), arp(8), rarp(8), ipchains(8)
+- ifconfig(8)
- - Prefixes for binary multiples
+- (Socket-CAN Project)
-Fred N. van Kempen, <>
-Alan Cox, <>
-Phil Blundell, <>
-Andi Kleen;
-Bernd Eckenfels, <>
+Robert Schwebel <>