1 files changed, 91 insertions, 0 deletions
diff --git a/share/examples/libifc/setdescription.c b/share/examples/libifc/setdescription.c
new file mode 100644
index 000000000000..d66a883a0e61
--- /dev/null
+++ b/share/examples/libifc/setdescription.c
@@ -0,0 +1,91 @@
+/*
+ * Copyright (c) 2016, Marie Helene Kvello-Aune
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice,
+ * thislist of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation and/or
+ * other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * $FreeBSD$
+ */
+
+#include <err.h>
+#include <errno.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <libifc.h>
+
+
+int main(int argc, char *argv[])
+{
+	if (argc != 3) {
+		errx(EINVAL, "Invalid number of arguments."
+		    " First argument should be interface name, second argument"
+		    " should be the description to set.");
+	}
+
+	char *ifname, *ifdescr, *curdescr;
+	/* We have a static number of arguments. Therefore we can do it simple. */
+	ifname = strdup(argv[1]);
+	ifdescr = strdup(argv[2]);
+	curdescr = NULL;
+
+	printf("Interface name: %s\n", ifname);
+
+	libifc_handle_t *lifh = libifc_open();
+	if (libifc_get_description(lifh, ifname, &curdescr) == 0) {
+		printf("Old description: %s\n", curdescr);
+	}
+
+	printf("New description: %s\n\n", ifdescr);
+
+	if (libifc_set_description(lifh, ifname, ifdescr) == 0) {
+		printf("New description successfully set.\n");
+	} else {
+		switch (libifc_err_errtype(lifh)) {
+		case SOCKET:
+			err(libifc_err_errno(lifh), "Socket error");
+			break;
+		case IOCTL:
+			err(libifc_err_errno(
+				    lifh), "IOCTL(%lu) error",
+			    libifc_err_ioctlreq(lifh));
+			break;
+		case OTHER:
+			err(libifc_err_errno(lifh), "Other error");
+			break;
+		}
+	}
+
+	free(ifname);
+	free(ifdescr);
+	free(curdescr);
+	ifname = NULL;
+	ifdescr = NULL;
+	curdescr = NULL;
+
+	libifc_close(lifh);
+	return (0);
+}