'\" t .\" Title: clk_get .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: June 2017 .\" Manual: Clock Framework .\" Source: Kernel Hackers Manual 4.11.3 .\" Language: English .\" .TH "CLK_GET" "9" "June 2017" "Kernel Hackers Manual 4\&.11\&" "Clock Framework" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" clk_get \- lookup and obtain a reference to a clock producer\&. .SH "SYNOPSIS" .HP \w'struct\ clk\ *\ clk_get('u .BI "struct clk * clk_get(struct\ device\ *\ " "dev" ", const\ char\ *\ " "id" ");" .SH "ARGUMENTS" .PP \fIstruct device * dev\fR .RS 4 device for clock \(lqconsumer\(rq .RE .PP \fIconst char * id\fR .RS 4 clock consumer ID .RE .SH "DESCRIPTION" .PP Returns a struct clk corresponding to the clock producer, or valid \fBIS_ERR\fR condition containing errno\&. The implementation uses \fIdev\fR and \fIid\fR to determine the clock consumer, and thereby the clock producer\&. (IOW, \fIid\fR may be identical strings, but clk_get may return different clock producers depending on \fIdev\fR\&.) .PP Drivers must assume that the clock source is not enabled\&. .PP clk_get should not be called from within interrupt context\&. .SH "COPYRIGHT" .br