summaryrefslogtreecommitdiff
path: root/kernel-devel/klist/pres_klist_en.tex
blob: 29091cba4928c00ce827f5c64d3576176d0e2dc3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
\input{configpres}

\title{klist}
\maketitle

\subsection{klist}

\begin{frame}
\frametitle{Overview}
\tableofcontents
\end{frame}

\subsubsection{What is it?}
\begin{frame}
\frametitle{klist functionality}
\begin{itemize}
\item Type oblivious - use with any data structure you have in mind
\item Doubly linked list
\item Iterations, etc. are easily readable
\end{itemize}
\end{frame}

\subsubsection{Usage}
\begin{frame}[fragile]
\frametitle{Initialization}
\begin{lstlisting}
struct my_elem {
        int member1;
        long member2;
        struct list_head node;
};

/* the following is the same as
 * struct list_head mylist;
 * INIT_LIST_HEAD(&mylist.list);
 */
LIST_HEAD(mylist);
\end{lstlisting}
\end{frame}

\begin{frame}[fragile]
\frametitle{Add elements}
\begin{lstlisting}
struct my_elem *e;
while( .. ) {
        e = kzalloc(sizeof(*e), GFP_KERNEL);
        e->member1 = 3;

        /* add element to the beginning of the list */
        list_add(&e->node, &mylist);

        /* to add element to the tail of the list use
         * list_add_tail(&e->node, &mylist);
         */
}
\end{lstlisting}
\end{frame}


\begin{frame}[fragile]
\frametitle{Iterate over list}
\begin{lstlisting}
struct my_elem *iterator, tmp;

/* last argument is name of struct list_head inside mylist */
list_for_each_entry(iterator, &mylist, node) {
        iterator->member1 = 0x08;
        iterator->member2 = 0x15;
}
\end{lstlisting}
\pause
\begin{lstlisting}
list_for_each_entry_reverse(iterator, &mylist, node)
        iterator->member1 = 0x08;
\end{lstlisting}
\pause
\begin{lstlisting}
/* clear list and free elements
 * _safe allows modificatio of the list during iteration
 */
list_for_each_entry_safe(iterator, tmp, &mylist, node) {
        list_del(&iterator->node);
        kfree(iterator);
}
\end{lstlisting}
\end{frame}

\begin{frame}
\frametitle{There are a lot of helpers!}
see: include/linux/list.h
\end{frame}

\input{tailpres}