76 lines
2.1 KiB
C
76 lines
2.1 KiB
C
|
/*
|
||
|
|
* glacier_log.h - Data structures for libglacier
|
||
|
|
*
|
||
|
|
* This file is part of Glacier.
|
||
|
|
*
|
||
|
|
* Glacier is free software: you can redistribute it and/or modify it under the terms of the
|
||
|
|
* GNU General Public License as published by the Free Software Foundation, either
|
||
|
|
* version 3 of the License, or (at your option) any later version.
|
||
|
|
*
|
||
|
|
* Glacier is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
|
||
|
|
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
||
|
|
* PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU General Public License along with Glacier. If
|
||
|
|
* not, see <https://www.gnu.org/licenses/>.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef GLACIERDATA_H_
|
||
|
|
#define GLACIERDATA_H_
|
||
|
|
|
||
|
|
/*
|
||
|
|
* create_node
|
||
|
|
*
|
||
|
|
* DESCRIPTION: Create_node creates a node for a dependency tree data structure.
|
||
|
|
* PARAMETERS:
|
||
|
|
* char *data -> The name of the node to create
|
||
|
|
* RETURN VALUES:
|
||
|
|
* None.
|
||
|
|
* CAVEATS:
|
||
|
|
* None.
|
||
|
|
* EXAMPLE:
|
||
|
|
* struct node package = create_node("Package");
|
||
|
|
*/
|
||
|
|
|
||
|
|
struct node *create_node(char *data);
|
||
|
|
|
||
|
|
/**************************************************************************************************************/
|
||
|
|
|
||
|
|
/*
|
||
|
|
* add_child
|
||
|
|
*
|
||
|
|
* DESCRIPTION: Add_child adds a child node to a parent node.
|
||
|
|
* PARAMETERS:
|
||
|
|
* struct node *parent -> The parent node which the child will be added to
|
||
|
|
* struct node *child -> The child node which will be added to the parent node
|
||
|
|
* RETURN VALUES:
|
||
|
|
* 1 on maximum children exceeded
|
||
|
|
* CAVEATS:
|
||
|
|
* None.
|
||
|
|
* EXAMPLE:
|
||
|
|
* add_child(package, dep1);
|
||
|
|
*/
|
||
|
|
|
||
|
|
void add_child(struct node *parent, struct node *child);
|
||
|
|
|
||
|
|
/**************************************************************************************************************/
|
||
|
|
|
||
|
|
/*
|
||
|
|
* print_tree
|
||
|
|
*
|
||
|
|
* DESCRIPTION: Print_tree prints a dependency tree specified at its root node
|
||
|
|
* PARAMETERS:
|
||
|
|
* struct node *root -> The tree to print
|
||
|
|
* int level -> The number of levels to descend
|
||
|
|
* RETURN VALUES:
|
||
|
|
* None.
|
||
|
|
* CAVEATS:
|
||
|
|
* None.
|
||
|
|
* EXAMPLE:
|
||
|
|
* print_tree(package, 0);
|
||
|
|
*/
|
||
|
|
|
||
|
|
void print_tree(struct node *root, int level);
|
||
|
|
|
||
|
|
#endif
|