summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRobert Schwebel <r.schwebel@pengutronix.de>2005-03-16 15:17:59 +0000
committerRobert Schwebel <r.schwebel@pengutronix.de>2005-03-16 15:17:59 +0000
commit45c875898aa71d7054c84bb0fe46b5a777691f26 (patch)
treed8151fe9142088a20255c81e62c0ebe1ef832586
parentc6f3feff0b1cfd4f85874a8d43b8e708fe67c2b1 (diff)
downloadcanutils-45c875898aa71d7054c84bb0fe46b5a777691f26.tar.gz
added documentation
git-svn-id: https://iocaste.extern.pengutronix.de/svn/canutils/trunks/canutils-1.0-trunks@5 5fd5a299-6ef2-0310-aa18-8b01d7c39d8c
-rw-r--r--canconfig.8252
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"
.SH NAME
-canconfig \- configure a CAN bus (Controller Area Network) interface
+canconfig \- configure a CAN bus interface
.SH SYNOPSIS
-.B "canconfig [interface]"
+.B "canconfig <interface>"
.br
-.B "canconfig interface [aftype] options | address ..."
+.B "canconfig <interface> baudrate { BR | BTR }"
+.br
+.B "canconfig <interface> mode MODE"
+.br
+.B "canconfig <interface> state"
.SH DESCRIPTION
-.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.
-.LP
-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
-(IPv6),
-.B ax25
-(AMPR Packet Radio),
-.B ddp
-(Appletalk Phase 2),
-.B ipx
-(Novell IPX) and
-.B netrom
-(AMPR Packet radio).
-.SH OPTIONS
+usage:
+ 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
+r
+
+.SH ARGUMENTS
.TP
.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.
-.TP
-.B up
-This flag causes the interface to be activated. It is implicitly
-specified if an address is assigned to the interface.
-.TP
-.B down
-This flag causes the driver for this interface to be shut down.
-.TP
-.B "[\-]arp"
-Enable or disable the use of the ARP protocol on this interface.
-.TP
-.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.
-.TP
-.B "[\-]allmulti"
-Enable or disable
-.B all-multicast
-mode. If selected, all multicast packets on the network will be
-received by the interface.
-.TP
-.B "metric N"
-This parameter sets the interface metric.
-.TP
-.B "mtu N"
-This parameter sets the Maximum Transfer Unit (MTU) of an interface.
-.TP
-.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.
-.TP
-.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.
-.TP
-.B "add addr/prefixlen"
-Add an IPv6 address to an interface.
-.TP
-.B "del addr/prefixlen"
-Remove an IPv6 address from an interface.
-.TP
-.B "tunnel aa.bb.cc.dd"
-Create a new SIT (IPv6-in-IPv4) device, tunnelling to the given destination.
-.TP
-.B "irq addr"
-Set the interrupt line used by this device. Not all devices can
-dynamically change their IRQ setting.
-.TP
-.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".
.TP
-.B "mem_start addr"
-Set the start address for shared memory used by this device. Only a
-few devices need this.
-.TP
-.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
-are
-.B 10base2
-(thin Ethernet),
-.B 10baseT
-(twisted-pair 10Mbps Ethernet),
-.B AUI
-(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.
-.TP
-.B "[-]broadcast [addr]"
-If the address argument is given, set the protocol broadcast
-address for this interface. Otherwise, set (or clear) the
-.B IFF_BROADCAST
-flag for the interface.
-.TP
-.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.
.br
-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
-.B IFF_POINTOPOINT
-flag for the interface.
-.TP
-.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
-(Ethernet),
-.B ax25
-(AMPR AX.25),
-.B ARCnet
-and
-.B netrom
-(AMPR NET/ROM).
-.TP
-.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.
+.br
+
+.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>
+
.TP
-.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
+
.TP
-.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.
-.SH NOTES
-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)
-command.
-.LP
-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 :)
-.LP
-Interrupt problems with Ethernet device drivers fail with EAGAIN
-.I (SIOCSIIFLAGS: Resource temporarily unavailable)
-it is most likely a interrupt conflict. See
-.I http://www.scyld.com/expert/irq-conflict.html
-for more information.
-.SH FILES
-.I /proc/net/socket
-.br
-.I /proc/net/dev
+.B state
+This command lets you ask for the interface status.
.br
-.I /proc/net/if_inet6
-.SH BUGS
-While appletalk DDP and IPX addresses will be displayed they cannot be
-altered by this command.
.SH SEE ALSO
-route(8), netstat(8), arp(8), rarp(8), ipchains(8)
+- ifconfig(8)
.br
-http://physics.nist.gov/cuu/Units/binary.html - Prefixes for binary multiples
+- http://www.pengutronix.de/software/socket-can/ (Socket-CAN Project)
.SH AUTHORS
-Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>
-.br
-Alan Cox, <Alan.Cox@linux.org>
-.br
-Phil Blundell, <Philip.Blundell@pobox.com>
-.br
-Andi Kleen;
-.br
-Bernd Eckenfels, <net-tools@lina.inka.de>
+Robert Schwebel <r.schwebel@pengutronix.de>