device_create_vargs(9) [centos man page]

DEVICE_CREATE_VARGS(9)					   Device drivers infrastructure				    DEVICE_CREATE_VARGS(9)

NAME

       device_create_vargs - creates a device and registers it with sysfs

SYNOPSIS

       struct device * device_create_vargs(struct class * class, struct device * parent, dev_t devt, void * drvdata, const char * fmt,
					   va_list args);

ARGUMENTS

       class
	   pointer to the struct class that this device should be registered to

       parent
	   pointer to the parent struct device of this new device, if any

       devt
	   the dev_t for the char device to be added

       drvdata
	   the data to be added to the device for callbacks

       fmt
	   string for the device's name

       args
	   va_list for the device's name

DESCRIPTION

       This function can be used by char device classes. A struct device will be created in sysfs, registered to the specified class.

       A "dev" file will be created, showing the dev_t for the device, if the dev_t is not 0,0. If a pointer to a parent struct device is passed
       in, the newly created struct device will be a child of that device in sysfs. The pointer to the struct device will be returned from the
       call. Any further sysfs files that might be required can be created using this pointer.

       Returns struct device pointer on success, or ERR_PTR on error.

NOTE

       the struct class passed to this function must have previously been created with a call to class_create.

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014						    DEVICE_CREATE_VARGS(9)

STRUCT 
CLASS(9) 					   Device drivers infrastructure					   STRUCT CLASS(9)

NAME

       struct_class - device classes

SYNOPSIS

       struct class {
	 const char * name;
	 struct module * owner;
	 struct class_attribute * class_attrs;
	 struct device_attribute * dev_attrs;
	 const struct attribute_group ** dev_groups;
	 struct bin_attribute * dev_bin_attrs;
	 struct kobject * dev_kobj;
	 int (* dev_uevent) (struct device *dev, struct kobj_uevent_env *env);
	 char *(* devnode) (struct device *dev, umode_t *mode);
	 void (* class_release) (struct class *class);
	 void (* dev_release) (struct device *dev);
	 int (* suspend) (struct device *dev, pm_message_t state);
	 int (* resume) (struct device *dev);
	 const struct kobj_ns_type_operations * ns_type;
	 const void *(* namespace) (struct device *dev);
	 const struct dev_pm_ops * pm;
	 struct subsys_private * p;
       };

MEMBERS

       name
	   Name of the class.

       owner
	   The module owner.

       class_attrs
	   Default attributes of this class.

       dev_attrs
	   Default attributes of the devices belong to the class.

       dev_groups
	   Default attributes of the devices that belong to the class.

       dev_bin_attrs
	   Default binary attributes of the devices belong to the class.

       dev_kobj
	   The kobject that represents this class and links it into the hierarchy.

       dev_uevent
	   Called when a device is added, removed from this class, or a few other things that generate uevents to add the environment variables.

       devnode
	   Callback to provide the devtmpfs.

       class_release
	   Called to release this class.

       dev_release
	   Called to release the device.

       suspend
	   Used to put the device to sleep mode, usually to a low power state.

       resume
	   Used to bring the device from the sleep mode.

       ns_type
	   Callbacks so sysfs can detemine namespaces.

       namespace
	   Namespace of the device belongs to this class.

       pm
	   The default device power management operations of this class.

       p
	   The private data of the driver core, no one other than the driver core can touch this.

DESCRIPTION

       A class is a higher-level view of a device that abstracts out low-level implementation details. Drivers may see a SCSI disk or an ATA disk,
       but, at the class level, they are all simply disks. Classes allow user space to work with devices based on what they do, rather than how
       they are connected or how they work.

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014							   STRUCT CLASS(9)