Skip to content

Commit

Permalink
phy: Clean up header style
Browse files Browse the repository at this point in the history
Multi-line comments weren't all CodingStyle compliant

Signed-off-by: Andy Fleming <afleming@freescale.com>
Signed-off-by: Jeff Garzik <jgarzik@redhat.com>
  • Loading branch information
Andy Fleming authored and Jeff Garzik committed Apr 17, 2008
1 parent 9d9326d commit c5e38a9
Showing 1 changed file with 32 additions and 16 deletions.
48 changes: 32 additions & 16 deletions include/linux/phy.h
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,8 @@
SUPPORTED_1000baseT_Half | \
SUPPORTED_1000baseT_Full)

/* Set phydev->irq to PHY_POLL if interrupts are not supported,
/*
* Set phydev->irq to PHY_POLL if interrupts are not supported,
* or not desired for this PHY. Set to PHY_IGNORE_INTERRUPT if
* the attached driver handles the interrupt
*/
Expand Down Expand Up @@ -80,8 +81,10 @@ typedef enum {
*/
#define MII_BUS_ID_SIZE (BUS_ID_SIZE - 3)

/* The Bus class for PHYs. Devices which provide access to
* PHYs should register using this structure */
/*
* The Bus class for PHYs. Devices which provide access to
* PHYs should register using this structure
*/
struct mii_bus {
const char *name;
char id[MII_BUS_ID_SIZE];
Expand All @@ -90,8 +93,10 @@ struct mii_bus {
int (*write)(struct mii_bus *bus, int phy_id, int regnum, u16 val);
int (*reset)(struct mii_bus *bus);

/* A lock to ensure that only one thing can read/write
* the MDIO bus at a time */
/*
* A lock to ensure that only one thing can read/write
* the MDIO bus at a time
*/
struct mutex mdio_lock;

struct device *dev;
Expand All @@ -102,8 +107,10 @@ struct mii_bus {
/* Phy addresses to be ignored when probing */
u32 phy_mask;

/* Pointer to an array of interrupts, each PHY's
* interrupt at the index matching its address */
/*
* Pointer to an array of interrupts, each PHY's
* interrupt at the index matching its address
*/
int *irq;
};

Expand Down Expand Up @@ -255,7 +262,8 @@ struct phy_device {
/* Bus address of the PHY (0-32) */
int addr;

/* forced speed & duplex (no autoneg)
/*
* forced speed & duplex (no autoneg)
* partner speed & duplex & pause (autoneg)
*/
int speed;
Expand All @@ -278,8 +286,10 @@ struct phy_device {

int link_timeout;

/* Interrupt number for this PHY
* -1 means no interrupt */
/*
* Interrupt number for this PHY
* -1 means no interrupt
*/
int irq;

/* private data pointer */
Expand Down Expand Up @@ -329,22 +339,28 @@ struct phy_driver {
u32 features;
u32 flags;

/* Called to initialize the PHY,
* including after a reset */
/*
* Called to initialize the PHY,
* including after a reset
*/
int (*config_init)(struct phy_device *phydev);

/* Called during discovery. Used to set
* up device-specific structures, if any */
/*
* Called during discovery. Used to set
* up device-specific structures, if any
*/
int (*probe)(struct phy_device *phydev);

/* PHY Power Management */
int (*suspend)(struct phy_device *phydev);
int (*resume)(struct phy_device *phydev);

/* Configures the advertisement and resets
/*
* Configures the advertisement and resets
* autonegotiation if phydev->autoneg is on,
* forces the speed to the current settings in phydev
* if phydev->autoneg is off */
* if phydev->autoneg is off
*/
int (*config_aneg)(struct phy_device *phydev);

/* Determines the negotiated speed and duplex */
Expand Down

0 comments on commit c5e38a9

Please sign in to comment.